🎬 Math Animation MCP

# 克隆项目
git clone https://github.com/bcefghj/math-animation-mcp.git
cd math-animation-mcp

# 一键启动（自动下载依赖）
docker compose up -d

# 打开浏览器
# → http://localhost:7860

{
  "mcpServers": {
    "math-animation": {
      "command": "uvx",
      "args": ["math-animation-mcp"],
      "env": { "OUTPUT_DIR": "./animation_output" }
    }
  }
}

帮我做一个勾股定理证明动画，适合初中生
@高考数学.pdf 讲解第18题
把这段导数知识点做成动画，黑板风格

pip install math-animation-mcp
math-animation-mcp --web       # 启动 Web 界面
# → http://localhost:7860

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装绘图库和视频工具
brew install cairo pango ffmpeg pkg-config

# 安装中文字体（不装的话中文会显示乱码）
brew install --cask font-noto-sans-cjk

# 安装 uv（现代 Python 包管理器，速度是 pip 的 10-100 倍）
curl -LsSf https://astral.sh/uv/install.sh | sh

# 让终端识别 uv 命令（关闭终端重新打开也行）
source ~/.zshrc

# 下载项目代码
git clone https://github.com/bcefghj/math-animation-mcp.git
cd math-animation-mcp

# 创建虚拟环境并安装（约 5-10 分钟）
uv venv .venv
source .venv/bin/activate
uv pip install -e ".[web,ocr]"

# 测试是否安装成功
python -c "import manim; print('Manim OK')"
python -c "from math_animation_mcp.utils.sandbox import render_manim_code; print('MCP OK')"

# 启动 Web 界面
python -m math_animation_mcp --web

# 输出类似：Running on local URL: http://127.0.0.1:7860

Set-ExecutionPolicy Bypass -Scope Process -Force
iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

choco install manimce ffmpeg -y

git clone https://github.com/bcefghj/math-animation-mcp.git
cd math-animation-mcp
pip install -e ".[web]"

python -m math_animation_mcp --web

# 第一步：安装系统依赖
sudo apt update
sudo apt install -y \
    libcairo2-dev libpango1.0-dev \
    ffmpeg python3-pip python3-venv \
    texlive-full fonts-noto-cjk \
    pkg-config cmake git

# 第二步：克隆项目
git clone https://github.com/bcefghj/math-animation-mcp.git
cd math-animation-mcp

# 第三步：创建虚拟环境
python3 -m venv .venv
source .venv/bin/activate

# 第四步：安装
pip install -e ".[web,ocr]"

# 第五步：启动
python -m math_animation_mcp --web

git clone https://github.com/bcefghj/math-animation-mcp.git
cd math-animation-mcp
docker compose up -d

docker compose down

git pull
docker compose up -d --build

帮我做一个展示正弦函数 y=sin(x) 的动画，展示振幅、频率、相位变化

帮我做一个 2025 高考数学第 18 题（椭圆）的讲解动画，
要求：题目先展示 → 一步步求解方程 → 画出椭圆图形 → 动点演示性质

@数学试卷.pdf 帮我讲解第 3 题，可汗学院风格，高中生受众

（上一个动画太快了）帮我把动画速度调慢一半，字体再大一点

cd math-animation-mcp
source .venv/bin/activate

# 运行 2025 高考第 19 题（导数）讲解
python3 -c "
import sys; sys.path.insert(0, 'src')
from math_animation_mcp.utils.sandbox import render_manim_code

with open('examples/gaokao_2025/gaokao_2025_19_derivative.py') as f:
    code = f.read()

result = render_manim_code(code, quality='low', output_dir='./output')
if result.success:
    print(f'成功！视频保存在: {result.file_path}')
"

# 运行 15 个基础案例（约 5 分钟）
python examples/basic_math/test_all_cases.py

# 运行 12 个进阶长案例（约 10 分钟）
python examples/basic_math/test_long_cases.py

# 启动 MCP Server（供 AI 工具调用）
python -m math_animation_mcp

# 或者直接用 uvx（无需安装）
uvx math-animation-mcp

{
  "mcpServers": {
    "math-animation": {
      "command": "uvx",
      "args": ["math-animation-mcp"]
    }
  }
}

# 启动 Web 界面
python -m math_animation_mcp --web

# 命令行直接渲染
python -m math_animation_mcp render \
  --text "勾股定理证明" \
  --style three_blue_one_brown \
  --quality medium \
  --output ./my_videos/

# 渲染指定 .py 文件
python -m math_animation_mcp render-file ./my_scene.py

# 查看所有可用模板
python -m math_animation_mcp list-templates

# 检查环境
python -m math_animation_mcp check

# macOS
brew install --cask font-noto-sans-cjk

# Ubuntu
sudo apt install fonts-noto-cjk

# Windows：下载 Noto CJK 字体
# https://www.google.com/get/noto/

export_video("output.mp4", aspect_ratio="9:16")  # 适合抖音/视频号

set_branding(watermark="张老师课堂", intro_text="张老师数学")

cd math-animation-mcp
git pull
source .venv/bin/activate
uv pip install -e . --upgrade

math-animation-mcp/
├── 📁 src/math_animation_mcp/
│   ├── server.py              # MCP Server（21个工具）
│   ├── web_server.py          # Gradio Web 界面
│   ├── cli.py                 # 命令行入口
│   ├── 📁 tools/              # 工具实现
│   │   ├── render_tools.py    # 渲染
│   │   ├── input_tools.py     # PDF/图片/OCR 处理
│   │   ├── repair_tools.py    # 自动修复
│   │   ├── template_tools.py  # 模板管理
│   │   ├── personalization_tools.py
│   │   └── export_tools.py
│   ├── 📁 templates/          # 预置模板库
│   │   ├── geometry/          # 几何
│   │   ├── algebra/           # 代数
│   │   ├── calculus/          # 微积分
│   │   ├── trigonometry/      # 三角
│   │   ├── statistics/        # 统计概率
│   │   ├── physics/           # 物理
│   │   └── cs/                # 计算机
│   ├── 📁 styles/presets.py   # 6种视觉风格
│   ├── 📁 config/             # 用户偏好
│   └── 📁 utils/              # 沙箱、中文支持、FFmpeg
│
├── 📁 examples/               # ✨ 可运行案例
│   ├── 📁 gaokao_2025/        # 2025 高考真题（3道大题）
│   │   ├── gaokao_2025_17_solid.py      # 立体几何
│   │   ├── gaokao_2025_18_ellipse.py    # 圆锥曲线
│   │   └── gaokao_2025_19_derivative.py # 导数压轴
│   └── 📁 basic_math/         # 基础数学（27个案例）
│       ├── test_all_cases.py            # 15个短案例
│       └── test_long_cases.py           # 12个长案例
│
├── 📁 docs/                   # 详细文档
│   ├── getting-started/
│   ├── tutorials/
│   └── faq/
│
├── 🐳 Dockerfile
├── 🐳 docker-compose.yml
├── 🔧 install.sh              # macOS/Linux 一键安装
├── 🔧 install.ps1             # Windows 一键安装
└── 📄 pyproject.toml