Skip to main content

MCP server that executes Manim animation code and returns the generated video

Project description

Manim MCP Server

Manim MCP Demo

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

Integration with Claude

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

  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 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 abhiemj. Contributions welcome! 🚀

Listed in Awesome MCP Servers

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

Acknowledgments

  • Thanks to the Manim Community for their amazing animation library.
  • Inspired by the open-source MCP ecosystem.

Find me at

aiburner_official @aiburner_official

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iflow_mcp_manim_mcp_server-0.1.0.tar.gz (4.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

iflow_mcp_manim_mcp_server-0.1.0-py3-none-any.whl (5.6 kB view details)

Uploaded Python 3

File details

Details for the file iflow_mcp_manim_mcp_server-0.1.0.tar.gz.

File metadata

File hashes

Hashes for iflow_mcp_manim_mcp_server-0.1.0.tar.gz
Algorithm Hash digest
SHA256 92e6c38dd525a4ebfb050c6415399fdf4d0d7dec82e314afa8b8fb8dc7b724bd
MD5 45601010e1fe4d2d4e912c87aa0590bb
BLAKE2b-256 2a90cb086d22492f4b58a9aa95e76483773e5bd046ea883579b209236f72c5a0

See more details on using hashes here.

File details

Details for the file iflow_mcp_manim_mcp_server-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for iflow_mcp_manim_mcp_server-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ed60c579b93f57f6a14cf8eee8d0691706c37ee1e202df88edeb2beae535ce4a
MD5 71423f2b2e82896fda935d23cce5a449
BLAKE2b-256 b4947451649b32a7d1e2dcbacc7de1abe987c840f970331655add7e931853125

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page