Manim MCP Server

1# Manim MCP Server
2 
3![Manim MCP Demo](Demo-manim-mcp.gif)
4 
5 
6## Overview
7 
8This 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.
9 
10## Features
11 
12- Executes Manim Python scripts.
13- Saves animation output in a visible media folder.
14- Allows users to clean up temporary files after execution.
15- Portable and configurable via environment variables.
16 
17## Installation
18 
19### Prerequisites
20 
21Ensure you have the following installed:
22 
23- Python 3.8+
24- Manim (Community Version)
25- MCP
26 
27### Install Manim
28 
29```sh
30pip install manim
31```
32 
33### Install MCP
34 
35```sh
36pip install mcp
37```
38 
39### Clone the Repository
40 
41```sh
42git clone https://github.com/abhiemj/manim-mcp-server.git
43cd manim-mcp-server
44```
45 
46## Integration with Claude
47 
48To integrate the Manim MCP server with Claude, add the following to your `claude_desktop_config.json` file:
49 
50```json
51{
52  "mcpServers": {
53     "manim-server": {
54      "command": "/absolute/path/to/python",
55      "args": [
56        "/absolute/path/to/manim-mcp-server/src/manim_server.py"
57      ],
58      "env": {
59        "MANIM_EXECUTABLE": "/Users/[Your_username]/anaconda3/envs/manim2/Scripts/manim.exe"
60      }
61    }
62  }
63}
64```
65 
66### Finding Your Python Path
67 
68To find your Python executable path, use the following command:
69 
70#### Windows (PowerShell):
71```sh
72(Get-Command python).Source
73```
74 
75#### Windows (Command Prompt/Terminal):
76```sh
77where python
78```
79 
80#### Linux/macOS (Terminal):
81```sh
82which python
83```
84 
85This ensures that Claude can communicate with the Manim MCP server to generate animations dynamically.
86 
87## Contributing
88 
891. Fork the repository.
902. Create a new branch:
91   ```sh
92   git checkout -b add-feature
93   ```
943. Make changes and commit:
95   ```sh
96   git commit -m "Added a new feature"
97   ```
984. Push to your fork:
99   ```sh
100   git push origin add-feature
101   ```
1025. Open a pull request.
103 
104## License
105 
106This 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.
107 
108## Author
109 
110Created by **[abhiemj](https://github.com/abhiemj)**. Contributions welcome! 🚀
111 
112### **Listed in Awesome MCP Servers**  
113This repository is featured in the [Awesome MCP Servers](https://github.com/punkpeye/awesome-mcp-servers) repository under the **Animation & Video** category. Check it out along with other great MCP server implementations!
114 
115 
116## **Acknowledgments**  
117- Thanks to the [Manim Community](https://www.manim.community/) for their amazing animation library.  
118- Inspired by the open-source MCP ecosystem.
119 
120## Find me at
121<a href="https://www.instagram.com/aiburner_official" target="blank"><img align="center" src="https://raw.githubusercontent.com/rahuldkjain/github-profile-readme-generator/master/src/images/icons/Social/instagram.svg" alt="aiburner_official" height="30" width="40" /></a>
122@aiburner_official
123