Abhiemj 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

This is an MCP (Model Context Protocol) server that executes Manim animation code and returns the generated video. It enables users to send Manim scripts and receive the rendered animations.

✨ Features

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

📦 Installation

Dependencies

Ensure the following are installed:

• Python 3.8+
• Manim (Community Edition)
• 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

Integrating with Claude

To integrate the Manim MCP server with Claude, add the following 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"
      }
    }
  }
}

Finding Your Python Path

To find your Python executable path, 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! 🚀

Featured 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 the outstanding animation library.
• Inspired by the open-source MCP ecosystem.