Blender Animation MCP

用于 Blender 的动画专用 MCP 服务器。它把精确的时间轴/关键帧工具与渲染后的视觉反馈结合起来，使多模态模型可以直接查看它生成的动画内容，而不仅仅依靠变换数据来推断。

import_glb_asset 可以导入带纹理或绑定的 GLB/glTF 资源，且不会展平其层级结构；inspect_rig 可以显示骨骼和绑定关系；key_pose_bone 则提供比直接操作原始 RNA 路径更安全的姿态设置接口。现有的内嵌动画剪辑会由 Blender 的 glTF 导入器导入，并纳入视觉检查中。

它可以查看和控制的内容

• 渲染任意精确帧，并作为 MCP 图像内容返回。

• 对整个镜头渲染一张采样联系表，便于快速视觉检查。

• 随时间采样计算后的世界空间变换和包围盒。

• 查看动作、F 曲线、关键帧柄、差值处理方式、NLA 片段、约束、相机和关键点。

• 插入/删除关键帧、改变差值方式、控制时间轴并保存文件。

• 导入任意 .glb 和 .gltf 资源，并保留其层级、材质、骨骼绑定和动画剪辑。

• 直接使用局部空间四元数检查骨架和关键骨骼。

• 识别出有权重的肢体链候选，并检查它们实际的局部坐标轴。

• 在地型姿态设置之前，以非破坏性的方式探测骨骼变形。

• 创建爪部 IK 控制器，在目标空间下设置关键帧，并验证脚部是否发生滑动。

联系表来自实际的可视化渲染，并且特意限制为最多 25 帧。如需更详细检查，请对可疑帧调用 render_frame。动画是时间性的，任何有限采样都无法证明每个中间帧都正确，因此建议的工作流程是：联系表查看 → 针对性选帧 → 数值估算 → 再作一次视觉检查。

Related MCP server: Blender MCP

安装

1. 先去 blender 时按 charades 格式进行（zip 必须包含 blender_addon 子系统，如 blender_addon/__``init``.py） blender_addon.__pycache__等目录打 zip：将 blender_addon 目录打包（压缩包内须包含 blender_addon/__init__.py），接着在 编辑 > 偏好设置 > 插件 > 从磁盘安装 中安装。启用 Animation MCP Bridge。

2. 该桥接插件会随 Blender 自动启动。可以在 场景属性 > Animation MCP 中查看其状态，或将其停止/重启。

3. 安装这个 MCP 包：

   pip install -e .

4. 将它添加为 MCP 客户端配置：

   {
     "mcpServers": {
       "blender-animation": {
         "command": "blender-animation-mcp",
         "env": {
           "BLENDER_MCP_HOST": "127.0.0.1",
           "BLENDER_MCP_PORT": "9876",
           "BLENDER_MCP_TOKEN": ""
         }
       }
     }
   }

出于安全考虑，桥接插件默认仅在本机（localhost）监听端口。如果你在 Blender 中配置了 token，请在 MCP 进程中设置相同的 BLENDER_MCP_TOKEN。不要将端口暴露到不可信网络中。

推荐的操作流程

1. 在编辑前先调用 inspect_scene 和 inspect_object_animation。 对于新导入的 GLB/glTF 资源，先调用 import_glb_asset，如果它有骨骼绑定，再调用 inspect_rig。

2. 设置关键帧和插值方式。

3. 对整个序列帧调用 inspect_animation_visual 检查动画画面。

如果是视频驱动的动作匹配，请先以 MP4 作为源调用 setup_video_reference，然后用 render_video_overlay 获取精确中有用的关键姿态；或者用 inspect_video_overlay 快速浏览联系表。调整 video_frame_offset 将 Blender 时间轴与参考视频的有效区间对齐，再给骨骼设置动画。

对于创建的绑定骨骼结构，还可尝试先调用 discover_limb_chains，用 inspect_bone_axes 检查候选骨骼，用 probe_bons_deformation 验证可动范围。确认后再用 create_limb_ik 创建四肢 IK，并通过 key_paw_pose 设置关键帧，再用 validate_walk_cycle 验证每次都是否正常落地。

4. 在触点附近、极限姿态处或明显不连续的位置，使用 render_frame 渲染检查。 5. 需要精确计算间距或世界坐标变化时，调用 evaluate_animation。 6. 反复调整，最后使用 save_blend 保存。

环境变量

BLENDER_MCP_HOST、BLENDER_MCP_PORT、BLENDER_MCP_TOKEN 和 BLENDER_MCP_TIMEOUT 用于配置 MCP 与 Blender 之间的连接。

若要在无窗口环境下运行 Blender，并在安装完插件后：

blender --background --python blender_addon/headless.py

自带的 systemd/blender-animation-mcp.service 可让该 worker 在 9877 端口上常驻运行。