SuperAPI AI 工具集

blender-mcp

设计与创作

查看项目

更新于 10-16 09:46

技能介绍

用途:通过 MCP 工具驱动活跃的 Blender 会话,完成网格、材质、动画、灯光和渲染等创建与修改任务。不涉及 Blender 界面操作流程,全部经由 MCP 工具执行。

前置条件:一次性安装 MCP 服务器,命令为 hermes mcp install blender;该命令会配置固定的 blender-mcp stdio 服务器,提供 get_scene_info、get_object_info、get_viewport_screenshot、execute_blender_code 工具。随后在 Blender 内安装插件:下载 https://raw.githubusercontent.com/ahujasid/blender-mcp/main/addon.py,经 Edit > Preferences > Add-ons > Install 选择 addon.py,并启用 “Interface: Blender MCP”。

会话用法:每次先启动 Blender,在视口按 N,打开 BlenderMCP 标签并点击 Connect to Claude 启动本地桥接 socket,再启动 Hermes 会话以加载 MCP 工具。插件不支持 blender -b 后台模式;无显示环境可用 xvfb-run blender。

工具分工:get_scene_info 用于先列出现有对象;get_object_info 检查单个对象的变换与材质;get_viewport_screenshot 做视觉确认;execute_blender_code 执行任意 bpy Python。可选资产服务工具默认关闭,如已在插件面板启用,可用 hermes mcp configure blender 选择启用其工具。

操作流程:先调用 get_scene_info,不要假设场景为空;用 execute_blender_code 分小步构建,每步一个逻辑动作,避免桥接超时;关键步骤间用截图验证;渲染到绝对路径并告知用户文件位置。

限制与注意:工具仅在服务器安装且会话在安装后启动时存在。每个 Blender 会话需重新连接插件,连接被拒绝说明 Blender 未运行或插件未连接。渲染路径必须是绝对路径,因其在 BLENDER 主机的文件系统上解析。shade_smooth() 需对象被选中且处于对象模式。execute_blender_code 无沙箱,信任级别等同终端工具,勿运行不可信代码。不要自行向 9876 端口发送原始 TCP JSON,应使用 MCP 工具。更多 bpy 操作、完整场景配方与版本陷阱见随附参考文件。