iflow-mcp-wstcpyt-manim-mcp

# Manim MCP     A Docker-based environment for creating mathematical animations with [Manim](https://www.manim.community/), 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](https://docs.docker.com/get-docker/) and Docker Compose installed on your system ### Installation #### Option 1: Use the Prebuilt Image (Recommended) Simply pull the prebuilt image from Docker Hub: ```bash docker pull wstcpyt/manim-docker-mcp:latest ``` Then run it with docker-compose: ```bash docker compose up -d ``` #### Option 2: Build Locally 1. Clone the repository: ```bash git clone https://github.com/YOUR_USERNAME/manim-docker-mcp.git cd manim-docker-mcp ``` 2. Build the Docker images: ```bash docker compose build ``` ### Usage #### CLI Mode Create a Python file in the `animations` directory (see example below), then run: ```bash docker compose run manim -pql animations/example.py ExampleScene ``` #### API Mode Start the API server: ```bash docker compose up -d manim-api ``` Access the API documentation at [http://localhost:8000/docs](http://localhost:8000/docs) ## 🎬 Creating Animations ### Basic Example Create a file `animations/example.py`: ```python from manim import * class CircleToSquare(Scene): def construct(self): circle = Ci…