Animated video MCP Server
Overview
This is an MCP (Model Context Protocol) server that executes Manim animation code and returns the generated video. It allows users to send Manim scripts and receive the rendered animation.
Features
- Executes Manim Python scripts.
- Saves animation output in a visible media folder.
- Allows users to clean up temporary files after execution.
- Portable and configurable via environment variables.
Installation
Prerequisites
Ensure you have the following installed:
- Python 3.8+
- Manim (Community Version)
- MCP
Install Manim
pip install manim
Install MCP
pip install mcp
Clone the Repository
git clone https://github.com/Gorav22/Animated_video.git
cd Animated_video
Integration with Claude
To integrate the Manim MCP server with Claude, add the following to your claude_desktop_config.json file:
{
"mcpServers": {
"animation-server": {
"command": "/absolute/path/to/python",
"args": [
"/absolute/path/to/manim-mcp-server/src/manim_server.py"
],
"env": {
"MANIM_EXECUTABLE": "/Path/to/manim/Scripts/manim.exe"
}
}
}
}
For cursor, Go to Cursor Settings then MCP then click new a mcp server add this script in mcp.json
{
"mcpServers": {
"animation-server": {
"command": "/absolute/path/to/python",
"args": [
"/absolute/path/to/manim-mcp-server/src/manim_server.py"
],
"env": {
"MANIM_EXECUTABLE": "/Path/to/manim/Scripts/manim.exe"
}
}
}
}
Finding Your Python Path
To find your Python executable path, use the following command:
Windows (PowerShell):
(Get-Command python).Source
Windows (Command Prompt/Terminal):
where python
Linux/macOS (Terminal):
which python
This ensures that Claude can communicate with the Manim MCP server to generate animations dynamically.
Contributing
- Fork the repository.
- Create a new branch:
git checkout -b add-feature - Make changes and commit:
git commit -m "Added a new feature" - Push to your fork:
git push origin add-feature - Open a pull request.
License
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
Author
Created by Gorav22. Contributions welcome! 🚀