Основанная на Docker среда для создания математических анимаций с Manim, с интерфейсом CLI и веб-API с поддержкой протокола Model Context Protocol (MCP) для помощников ИИ.

Обзор

Этот проект предусматривает:

1. ** Контейнеризованная среда манима**: запустите маним в изолированной, воспроизводимой среде Докера
2. ** Web API**: Создание и управление анимацией Manim с помощью HTTP-запросов
3. **MCP Интеграция **: Прямое взаимодействие с помощниками ИИ, такими как Клод
4. ** Управление файлами**: Скачать скрипты и скачать сгенерированные анимации

Быстрый старт

Предпосылки

Docker и Docker Compose установлены в вашей системе

###Установка

Вариант 1: Используйте предварительное изображение

Просто вытащите предварительное изображение из Docker Hub:

Затем запустите его с помощью docker-compose:

Вариант 2: Построить локально

1. Клонировать хранилище:

2.Создайте изображения Docker:

Использование

Режим CLI

Создайте файл Python в каталоге animations (см. пример ниже), затем запустите:

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