Manim MCP Server

🚀 Manim MCP Server

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 rendered animations.

🚀 Quick Start

The Manim MCP Server is designed to execute Manim Python scripts and return the generated animations. Here's how you can get started with it.

✨ Features

• Execute Manim Python scripts.
• Save animation outputs in a visible media folder.
• Allow users to clean up temporary files after execution.
• Portable and configurable via environment variables.

📦 Installation

Prerequisites

Make sure 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/abhiemj/manim-mcp-server.git
cd manim-mcp-server

💻 Usage Examples

Integrate with Claude

To integrate the Manim MCP Server with Claude, add the following content to the claude_desktop_config.json file:

{
  "mcpServers": {
     "manim-server": {
      "command": "/absolute/path/to/python",
      "args": [
        "/absolute/path/to/manim-mcp-server/src/manim_server.py"
      ],
      "env": {
        "MANIM_EXECUTABLE": "/Users/[Your_username]/anaconda3/envs/manim2/Scripts/manim.exe"
      }
    }
  }
}

Find Your Python Path

To find the path to your Python executable, use the following commands:

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 dynamically generate animations.

🤝 Contribution

1. Fork the repository.
2. Create a new branch:

   git checkout -b add-feature
   

3. Make changes and commit:

   git commit -m "Added a new feature"
   

4. Push to your fork:

   git push origin add-feature
   

5. Open a pull request.

📄 License

This MCP server is released 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, see the LICENSE file in the project repository.

👨‍💻 Author

Created by abhiemj. Contributions are welcome! 🚀

Listed in Awesome MCP Servers

This repository is featured under the Animation & Video category in the Awesome MCP Servers repository. Check it out along with other great MCP server implementations!

🙏 Acknowledgments

• Thanks to the Manim Community for providing an excellent animation library.
• Inspired by the open-source MCP ecosystem.