Manim MCP Server

# Quick Start Guide Get up and running with Manim MCP in 5 minutes! ## Step 1: Install Manim MCP ### Easiest: MCPB Bundle (One-Click) 1. Download the `.mcpb` file from [Releases](https://github.com/Stelath/manim-mcp/releases) 2. Double-click the file (or drag into Claude Desktop) 3. Follow the installation prompts 4. Skip to Step 2 below! ### Alternative: Manual Install **Option 1: Direct from GitHub** ```bash pip install git+https://github.com/Stelath/manim-mcp.git ``` **Option 2: Clone and Install** ```bash git clone https://github.com/Stelath/manim-mcp.git cd manim-mcp ./install.sh # macOS/Linux # OR install.bat # Windows ``` **Then configure Claude Desktop** (see Step 3) ## Step 2: Install System Dependencies Choose your operating system: ### macOS ```bash brew install py3cairo ffmpeg brew install --cask mactex-no-gui ``` ### Ubuntu/Debian ```bash sudo apt-get update sudo apt-get install build-essential python3-dev libcairo2-dev libpango1.0-dev ffmpeg texlive texlive-latex-extra ``` ### Windows ```powershell choco install manimce ``` ## Step 3: Configure Claude Desktop **If you used MCPB (Option 1):** Skip this step! Configuration is automatic. **If you used manual install:** Configure Claude Desktop manually: 1. Open Claude Desktop configuration: - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` - **Linux**: `~/.config/Claude/claude_desktop_config.json` 2. Add this simple configuration: ```json { "mcpServers": { "manim": { "command": "manim-mcp" } } } ``` That's it! No paths or environment variables needed. 3. Restart Claude Desktop ## Step 4: Test It Out! Open Claude Desktop and try: ``` Create a Manim animation that shows the Pythagorean theorem: a² + b² = c² Animate the equation being written and add a right triangle. ``` ## Step 5: Find Your Videos Generated videos are saved to: - **macOS/Linux**: `/tmp/manim_mcp_output/` - **Windows**: `C:\Users\{username}\AppData\Local\Temp\manim_mcp_output\` ## Common Issues ### "Command not found" or "Module not found" - Make sure you installed the package: `pip install git+https://github.com/Stelath/manim-mcp.git` - Verify installation: `manim-mcp --help` (should show no errors) - Try reinstalling: `pip install --force-reinstall git+https://github.com/Stelath/manim-mcp.git` ### Manim rendering errors - Verify system dependencies are installed - Test independently: `manim --version` ### Server doesn't appear in Claude Desktop - Check configuration file syntax (valid JSON) - Restart Claude Desktop completely - Check for typos in the configuration ## Next Steps - Read the [full README](README.md) for detailed documentation - Check out [Manim examples](https://docs.manim.community/en/stable/examples.html) - Experiment with different animation types!