Manimで数学的なアニメーションを作成するためのDockerベースの環境で、CLIインターフェイスとWeb APIとモデルコンテキストプロトコル(MCP)がAIアシスタントをサポートします。

## 状況

このプロジェクトは:

1. 達成されたマニム環境:分離された、再現可能なドッカー環境でマニムを実行して下さい 2.Web API: アニメーションをHTTPリクエストで作成および管理 3.MCPの統合:ClaudeのようなAIの助手との直接相互作用 4.ファイル管理: スクリプトのアップロードと生成されたアニメーションのダウンロード

すぐにスタート

前提条件

• あなたのシステムにDockerとDocker Composeがインストール

インストール

Option 1: プレビルドイメージ(推奨)を使用する

Docker Hub からビルド済みのイメージをプルするだけです。

その後、docker-compose で実行します。

####Option 2: ローカルに構築

1. リポジトリのクローン化:

2。 Dockerイメージを作成する:

使用法

###CLIモード

[animations ディレクトリに Python ファイルを作成します(以下を参照)、次に実行します。

####API モード

API サーバーを起動します。

[[T1] で API のドキュメントにアクセスします。

作成アニメーション

##基本例

ファイルを作成する [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