English · 中文
🎬 manim-web
AI × Math Animation — 让 AI 成为你的动画导演
说一句话，AI 帮你写代码、渲染、预览 — 全程浏览器实时可见
🟢 本项目活跃维护中 · 欢迎加入
每一行代码都值得被守护，每一个 idea 都值得被实现
pip install manim-web-mcp · 快速上手 · AI 使用指南 · API 参考
🎥 看看效果
🔵 图形变换 |
📐 数学公式 |
 |
 |
web_persistent_add("Circle → Square → Triangle") |
web_persistent_add("MathTex a²+b²=c²") |
📈 函数图像 |
✨ 综合动画 |
 |
 |
web_persistent_add("Axes + sin(x) + cos(x)") |
web_persistent_play("DrawBorderThenFill") |
💡 上面每个动画，AI 只需 3 行 MCP 调用就能生成
web_persistent_start(project="demo") # 🚀 启动
web_persistent_add(code="c = Circle(radius=1, color=BLUE)") # 🎨 创建图形
web_persistent_add(code="self.play(Create(c))") # ▶️ 播放动画
web_persistent_render_video() # 🎬 导出视频
⚡ 30 秒上手
pip install manim-web-mcp # 📦 内置优化版 manim，无需 pip install manim
manim-web-mcp # 🚀 启动！浏览器自动打开预览
📋 系统依赖
- Python 3.12+
- ffmpeg — 视频编码
- Cairo + Pango — 矢量渲染 & 文字
- TeX Live（可选）— LaTeX 公式渲染
🔥 为什么选 manim-web
| manim-web | 传统 CLI | VSCode 插件 | 在线 Playground | |
|---|---|---|---|---|
| AI 驱动 | ✅ MCP 协议 | ❌ | ❌ | ❌ |
| 浏览器实时预览 | ✅ WebSocket | ❌ | 仅 VSCode | ✅ |
| 会话跨对话保持 | ✅ 持久化 | ❌ | ❌ | ❌ |
| 多项目并行 | ✅ 独立场景 | ❌ | ❌ | ❌ |
| 沙箱安全 | ✅ 三级策略 | ❌ | ❌ | ❌ |
🎯 解决的痛点
| 痛点 | 之前 | manim-web |
|---|---|---|
| AI 写动画 | CLI 一步步试，看不到效果 | MCP 一句话，浏览器实时预览 |
| manim 安装 | 依赖链长，配置复杂 | pip install 一步到位，内置优化版 |
| 动画调试 | 改代码 → 渲染 → 看结果，循环慢 | 代码即预览，增量渲染秒级响应 |
| 跨对话丢失 | AI 对话结束，场景消失 | 会话持久化，跨对话无缝续接 |
| 代码安全 | AI 生成代码直接执行 | 三级沙箱，危险操作拦截 |
| 多项目并行 | 一个终端一个场景 | 独立项目空间，互不干扰 |
🛠 MCP 工具一览
| 🔥 核心 | 说明 |
|---|---|
web_persistent_start |
启动项目 + 打开浏览器预览 |
web_persistent_add |
执行 manim 代码（最常用） |
web_persistent_play |
快捷播放动画 |
web_persistent_mobject |
快捷创建图形 |
| 👁 预览 | 说明 |
|---|---|
web_persistent_frame |
查看当前帧 |
web_persistent_capture |
高质量截图 |
web_persistent_render_video |
渲染 mp4 / gif / webm |
| ⚙️ 管理 | 说明 |
|---|---|
web_persistent_export |
导出 .py 文件 |
web_persistent_reset |
重置场景 |
web_persistent_status |
查询状态 |
web_persistent_list |
列出所有项目 |
web_persistent_stop |
停止会话 |
📖 MCP 工具参考 · manim API 参考 — 74 动画 + 141 图形 + 40 缓动 + 149 工具
🔒 沙箱安全
| 级别 | 文件 I/O | import | exec/eval | 用途 |
|---|---|---|---|---|
strict |
❌ | ❌ | ❌ | 默认，最安全 |
relaxed |
仅项目目录 | 白名单 | ❌ | 需要读写文件 |
full |
✅ | ✅ | ✅ | 完全信任 + 危险检测 |
📚 文档
| 📖 | 链接 |
|---|---|
| 🚀 快速上手 | 5 分钟入门 |
| 🤖 AI 使用指南 | MCP 标准流程 |
| 🔧 工具参数 | MCP 工具参考 |
| 📐 API 签名 | manim API 参考 |
| 🏗 架构设计 | 模块架构 |
| 📝 更新日志 | 版本历史 |
| ❓ 常见问题 | 故障排查 |
🚀 路线图
| 方向 | 描述 | 状态 |
|---|---|---|
| 🔌 manim 插件适配 | 兼容社区插件生态，扩展动画能力 | 🔜 |
| 📦 manim 版本跟踪 | 上游版本自动同步，始终最新 | 🔜 |
| 🎙️ 语音旁白生成 | AI 配音 + 动画一体化输出 | 🔜 |
| 🧩 多客户端深度适配 | Claude / Cursor / Windsurf / Cline 等专项优化 | 🔜 |
| 📊 动画模板市场 | MCP 一键调用社区模板，开箱即用 | 📋 |
| 🔄 MCP 资源协议 | 支持 resources / prompts 标准扩展 | 📋 |
| 🎯 流式渲染推送 | MCP 增量输出，边生成边预览 | 📋 |
| 🖼️ 多模态输入 | 图片 / 手绘 / Sketch → manim 动画 | 📋 |
💡 有想法？提个 Issue 或 开个 Discussion — 你的声音塑造路线图
🤝 开源不止于 Fork
代码可以复制，生态需要共建。
manim-web 始终保持活跃开发。如果你正在阅读这份源码——无论是学习、改造还是构建自己的项目——我们都欢迎你回来：
- 🐛 提交 Issue — 发现问题就是贡献
- 🔧 提交 PR — 一行修复也是力量
- 📖 完善文档 — 帮助后来者就是帮助自己
- 💬 参与讨论 — 你的想法塑造未来
一个人走得快，一群人走得远。
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
manim_web_mcp-2.0.17.tar.gz
(12.5 MB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file manim_web_mcp-2.0.17.tar.gz.
File metadata
- Download URL: manim_web_mcp-2.0.17.tar.gz
- Upload date:
- Size: 12.5 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.0 {"installer":{"name":"uv","version":"0.11.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f9a8ae75604c158bf446606abc5d1c00646aa2a5e858322dab5b623c9977290e
|
|
| MD5 |
f5d1103d2167eb2aab9c846f0044426a
|
|
| BLAKE2b-256 |
d9c5bfbca2bd1d311abb2096f75c02a8d1ca5e73eb3faafd142cde644afdbc3d
|
File details
Details for the file manim_web_mcp-2.0.17-py3-none-any.whl.
File metadata
- Download URL: manim_web_mcp-2.0.17-py3-none-any.whl
- Upload date:
- Size: 6.4 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.0 {"installer":{"name":"uv","version":"0.11.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9c8805b96a44ff2bf8fbc6180021c83be9502e31bc21629206af762d7f88c0ff
|
|
| MD5 |
d50690ce22d038ef54dc25c417da8a12
|
|
| BLAKE2b-256 |
50547c3460af3ccd957bb0cc9b0ce719cad0729a4cbeee77b3f980b7dfa75576
|
