Manim과 수학 애니메이션 제작을 위한 Docker 기반 환경으로 CLI 인터페이스와 AI 조수에 대한 Model Context Protocol (MCP) 지원으로 웹 API를 갖추고 있습니다.

📑 개요

이 프로젝트는:

1.Containerized Manim Environment: 격리된, 재현 가능한 Docker 환경에서 Manim을 실행 2. ** 웹 API **: HTTP 요청을 통해 Manim 애니메이션 생성 및 관리 3. ** MCP 통합 ** : Claude와 같은 AI 보조와 직접 상호 작용 4. ** 파일 관리 **: JavaScript licenses API 웹 사이트

⭐ 빠른 시작

# 필수품

• 시스템에서 Docker 및 Docker Compose 설치

설치

옵션 1: 사전 제작 된 이미지 사용 (추천)

Docker Hub의 사전 제작된 이미지를 간단히 끌어보세요:

그런 다음 docker-compose로 실행하십시오.

옵션 2: 로컬로 빌드

1. 저장소를 복제:

2. Docker 이미지를 만드십시오:

사용법

CLI 모드

animations] 디렉토리에 Python 파일을 생성 (아래 예제 참조), 다음 실행:

API 모드

API 서버 시작:

API 문서에 액세스 http://localhost:8000/docs

. 애니메이션 만들기

기본 예제

파일 생성 animations/example.py:

애니메이션 실행

Manim MCP

A Docker-based environment for creating mathematical animations with Manim, featuring both a CLI interface and a web API with Model Context Protocol (MCP) support for AI assistants.

📑 Overview

This project provides:

1. Containerized Manim Environment: Run Manim in an isolated, reproducible Docker environment
2. Web API: Create and manage Manim animations via HTTP requests
3. MCP Integration: Direct interaction with AI assistants like Claude
4. File Management: Upload scripts and download generated animations

🚀 Quick Start

Prerequisites

• Docker and Docker Compose installed on your system

Installation

Option 1: Use the Prebuilt Image (Recommended)

Simply pull the prebuilt image from Docker Hub:

docker pull wstcpyt/manim-docker-mcp:latest

Then run it with docker-compose:

docker compose up -d

Option 2: Build Locally

1. Clone the repository:

   git clone https://github.com/YOUR_USERNAME/manim-docker-mcp.git
   cd manim-docker-mcp
   

2. Build the Docker images:

   docker compose build
   

Usage

CLI Mode

Create a Python file in the animations directory (see example below), then run:

docker compose run manim -pql animations/example.py ExampleScene

API Mode

Start the API server:

docker compose up -d manim-api

Access the API documentation at http://localhost:8000/docs

🎬 Creating Animations

Basic Example

Create a file animations/example.py:

from manim import *

class CircleToSquare(Scene):
    def construct(self):
        circle = Circle()
        circle.set_fill(BLUE, opacity=0.5)

        square = Square()
        square.set_fill(RED, opacity=0.5)

        self.play(Create(circle))
        self.wait()
        self.play(Transform(circle, square))
        self.wait()

Running the Animation

# CLI mode with preview (-p), low quality (-ql)
docker compose run manim -pql animations/example.py CircleToSquare

# API mode
curl -X POST "http://localhost:8000/run-manim?filepath=/manim/temp/circle_example.py&scene_name=CircleToSquare&quality=low_quality"

📂 Project Structure

manim-docker-mcp/
├── animations/           # Manim animation scripts
├── app/                  # FastAPI application
├── media/                # Generated animations (CLI mode)
├── output/               # Generated animations (API mode)
├── temp/                 # Temporary files
├── uploads/              # Uploaded animation scripts
├── Dockerfile            # Docker image definition