manimgl-mcp

# manimgl-mcp A Model Context Protocol (MCP) server that gives AI assistants the ability to create mathematical animations programmatically. Features RAG-powered code generation, multi-agent pipelines, and audio narration. ## What This Does This MCP server exposes **25 tools** that allow AI models to: 1. **Generate Animation Code** - Write scene definitions with RAG-powered assistance 2. **Render Videos** - Produce MP4, GIF, or PNG outputs at various quality levels 3. **Interactive Development** - Headless IPython sessions for iterative code testing 4. **Multi-Agent Pipeline** - Concept analysis → scene planning → code generation → review 5. **Audio Narration** - Generate TTS narration synced to videos ## Key Features - **RAG-Powered Code Generation** - Semantic search over indexed ManimGL API and examples - **Multi-Provider LLM** - Supports Gemini, Claude, DeepSeek, GPT-4o via litellm - **Parameter Validation** - Validates API calls against indexed signatures - **Self-Learning** - Stores error patterns and fixes for continuous improvement - **8 Animation Templates** - Riemann sums, matrix transforms, Fourier series, etc. ## System Requirements - **Python 3.10–3.13** — Python 3.14+ is **not** supported. `manimlib` depends on `pydub`, which requires the `audioop` standard library module removed in Python 3.13. Use a Python ≤ 3.13 environment. - **FFmpeg** — for video encoding - **LaTeX** — for mathematical notation (optional) No display server is required. Interactive sessions are fully headless — they run inside a plain IPython REPL with manimlib pre-loaded, no OpenGL window is ever opened. ## Installation ### Recommended: install into a Python 3.13 venv ```bash # Create a Python 3.13 virtual environment python3.13 -m venv ~/.venv # Install from PyPI uv pip install manimgl-mcp --python ~/.venv/bin/python # Or from source git clone https://github.com/pranavgundu/manimgl-mcp.git cd manimgl-mcp uv pip install -e . --python ~/.venv/bin/python ``` ### Sys…