Manim MCP 服务器

概述

这是一个 MCP（模型上下文协议）服务器，用于执行 Manim 动画代码并返回生成的视频。它允许用户发送 Manim 脚本，并接收渲染后的动画。

特性

• 执行 Manim Python 脚本。
• 将动画输出保存到可见的媒体文件夹中。
• 允许用户在执行后清理临时文件。
• 可移植且可通过环境变量进行配置。

安装

前置条件

请确保已安装以下内容：

• Python 3.8+
• Manim（社区版）
• MCP

安装 Manim

pip install manim

安装 MCP

pip install mcp

克隆仓库

git clone https://github.com/abhiemj/manim-mcp-server.git
cd manim-mcp-server

与 Claude 集成

要将 Manim MCP 服务器与 Claude 集成，请在 claude_desktop_config.json 文件中添加以下内容：

{
  "mcpServers": {
     "manim-server": {
      "command": "/绝对路径/to/python",
      "args": [
        "/绝对路径/to/manim-mcp-server/src/manim_server.py"
      ],
      "env": {
        "MANIM_EXECUTABLE": "/Users/[你的用户名]/anaconda3/envs/manim2/Scripts/manim.exe"
      }
    }
  }
}

查找 Python 路径

要查找 Python 可执行文件的路径，请使用以下命令：

Windows（PowerShell）：

(Get-Command python).Source

Windows（命令提示符/终端）：

where python

Linux/macOS（终端）：

which python

这将确保 Claude 能够与 Manim MCP 服务器通信，以动态生成动画。

贡献

1. 分支仓库。
2. 创建新分支：

   git checkout -b add-feature
   

3. 进行更改并提交：

   git commit -m "添加了新功能"
   

4. 推送到您的分支：

   git push origin add-feature
   

5. 打开拉取请求。

许可证

此 MCP 服务器采用 MIT 许可证授权。这意味着您可以自由地使用、修改和分发该软件，但需遵守 MIT 许可证的条款和条件。有关详细信息，请参阅项目仓库中的 LICENSE 文件。

作者

由 abhiemj 创建。欢迎贡献！🚀

收录于 Awesome MCP 服务器

本仓库已被收录于 Awesome MCP 服务器 仓库的 动画与视频 类别中。请查看它以及其他优秀的 MCP 服务器实现！

致谢

• 感谢 Manim 社区 提供的优秀动画库。
• 灵感来源于开源的 MCP 生态系统。

在这里找到我

@aiburner_official

Manim MCP Server 快速上手指南

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：Windows、Linux 或 macOS
• Python 版本：3.8 或更高
• 前置依赖：
  • Manim (社区版)：用于生成数学动画的 Python 库
  • MCP：模型上下文协议服务端

💡 国内加速建议：安装 Python 包时，推荐使用清华或阿里镜像源以提升下载速度。 例如：pip install -i https://pypi.tuna.tsinghua.edu.cn/simple <包名>

安装步骤

1. 安装 Manim 和 MCP

打开终端（或 PowerShell/CMD），执行以下命令安装核心依赖：

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple manim
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple mcp

2. 克隆项目仓库

获取 manim-mcp-server 源代码：

git clone https://github.com/abhiemj/manim-mcp-server.git
cd manim-mcp-server

基本使用

本工具主要作为 Claude Desktop 的 MCP 服务端运行，使 Claude 能够直接调用 Manim 生成动画视频。

1. 配置 Claude Desktop

找到您的 claude_desktop_config.json 配置文件，添加以下 mcpServers 配置项。

注意：请将 /absolute/path/to/python 替换为您实际的 Python 解释器路径，将 manim_server.py 的路径替换为实际克隆后的路径。

{
  "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"
      }
    }
  }
}

2. 获取 Python 和 Manim 路径

如果您不确定可执行文件的路径，请使用以下命令查询：

查找 Python 路径：

• Windows (PowerShell):

  (Get-Command python).Source
  

• Windows (CMD):

  where python
  

• Linux/macOS:

  which python
  

查找 Manim 路径： 通常在您的虚拟环境 bin (Linux/macOS) 或 Scripts (Windows) 目录下，名为 manim 或 manim.exe。

3. 开始生成动画

配置完成后，重启 Claude Desktop。您现在可以直接在对话框中向 Claude 发送指令，例如：

“请帮我写一段 Manim 代码，绘制一个正弦波函数图像，并渲染成视频。”

Claude 将通过 MCP 协议自动调用本地 Manim 环境执行代码，并将生成的视频文件返回给您查看。生成的媒体文件通常保存在配置的可见媒体文件夹中。