Manim MCP

基本能力

产品定位

Manim MCP 是一个用于创建数学动画的 Docker 化环境，支持 CLI 和 Web API 两种方式，特别适合开发者和 AI 助手集成使用。

核心功能

1. 容器化 Manim 环境：在隔离的 Docker 环境中运行 Manim，确保环境一致性。
2. Web API：通过 HTTP 请求创建和管理动画。
3. MCP 集成：支持 AI 助手直接交互，如 Claude。
4. 文件管理：上传脚本和下载生成的动画。

适用场景

1. 开发者需要快速创建数学动画。
2. AI 助手需要生成数学动画并返回给用户。
3. 教育场景中需要演示数学概念。

工具列表

1. Docker：提供容器化环境。
2. FastAPI：提供 Web API 功能。
3. Manim：核心动画引擎。

常见问题解答

1. Docker 未运行：确保 Docker 守护进程正在运行。
2. 权限错误：容器需要写入挂载卷的权限。
3. 媒体文件缺失：检查正确的输出目录（CLI 模式为 media/，API 模式为 output/）。

使用教程

使用依赖

• 安装 Docker 和 Docker Compose： ```bash # 安装 Docker sudo apt-get update sudo apt-get install docker-ce docker-ce-cli containerd.io

# 安装 Docker Compose sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose sudo chmod +x /usr/local/bin/docker-compose ```

安装教程

选项 1：使用预构建镜像（推荐）

docker pull wstcpyt/manim-docker-mcp:latest
docker compose up -d

选项 2：本地构建

1. 克隆仓库： bash git clone https://github.com/YOUR_USERNAME/manim-docker-mcp.git cd manim-docker-mcp
2. 构建 Docker 镜像： bash docker compose build

调试方式

CLI 模式

docker compose run manim -pql animations/example.py ExampleScene

API 模式

docker compose up -d manim-api

访问 API 文档：http://localhost:8000/docs

许可证

该项目遵循 Apache-2.0 开源许可条款，请参阅 Apache-2.0 了解完整条款。