如何一句话驱动 Blender 建模:BlenderMCP 快速上手指南
【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp
BlenderMCP 是一个开源的 MCP 插件,把 Blender 接到 Claude 等 AI 助手上,让你用一句话就能创建、修改和管理 3D 场景。装好它,你不用再啃菜单和参数表,AI 会直接在你打开的 Blender 里动手:建模型、打灯光、换材质,新手也能快速产出可用的 3D 作品。
为什么需要它
如果你试过在聊天窗口里聊 3D,多半会碰到一个尴尬场面:AI 讲得头头是道,Blender 那边却纹丝不动。BlenderMCP 解开的就是这道"说得多、做得少"的结——它在 AI 与 Blender 之间架了一条实时通道,让大模型直接在你当前的场景里执行操作 🧊
没有这条通道时,常见的卡点有:
- 想加一盏聚光灯,得一层层翻菜单,角度和光强全靠试;
- 调相机焦距、传感器尺寸这类参数,没有即时反馈,只能来回截图肉眼比;
- AI 写的 Python 脚本要自己复制到 Blender 控制台执行,中间容易漏行;
- 找 HDRI、纹理得切到浏览器下载,再手动拖进场景,链路又长又断。
先跑起来
环境要求很轻:Blender 3.0 及以上(推荐 4.x)、Python 3.10+、最新版 uv 包管理器,并且 Blender 要正常以图形界面启动(后台模式不行)。
安装按顺序走 4 步:
- 装 uv。macOS 执行 brew install uv 即可,其他系统方式见 README 安装说明。
- 在 AI 客户端登记 MCP 服务。以 Claude Desktop 为例:设置 → 开发者 → 编辑配置,加入
"blender": {"command": "uvx", "args": ["blender-mcp"]}。 - 装 Blender 插件。先克隆仓库(git clone 地址:https://gitcode.com/GitHub_Trending/bl/blender-mcp),然后在 Blender 里 编辑 → 偏好设置 → 附加组件 → 安装,选中仓库根目录的 addon.py,启用 "Interface: Blender MCP"。
- 在 3D 视图按 N 键打开侧边栏,切到 BlenderMCP 面板,点击 Connect to Claude。
看到 AI 客户端里出现小锤子图标、面板显示已连接,就代表链路打通了 ✅
核心功能怎么用
场景信息获取(get_scene_info)
先让 AI "看懂"现场:它会整理出场景名、对象、材质、灯光和相机的结构化信息。示例指令:"告诉我当前场景里有哪些对象,各用了什么材质。"
视口截图(get_viewport_screenshot)
AI 能直接看到你的视口画面 📸 这是它动手后自检的依据——每轮改动都让它截图确认,效果是否朝预期走,不用自己开两个窗口比。
执行 Blender Python(execute_blender_code)
细粒度操作走这条路:AI 生成 Python 代码,直接在 Blender 内运行,改焦距、换材质都够用(服务端逻辑见 server.py)。它跑的是真实代码,动手前先存文件。
Poly Haven 资源下载
在侧边栏勾选 Poly Haven 开关后,AI 可以在线帮你挑 HDRI、纹理和模型并直接导入场景,省去浏览器下载再手动拖入的来回。
实战演练
任务:让 AI 30 秒搭好一个"聚光灯下的产品展台"。
- 先说"获取当前场景信息",让 AI 通过 get_scene_info 摸清基线,确认场景是空的。
- 下指令:"创建展台立方体,上面放一个当产品的球体,分别赋灰白和金属材质。"
- 补一句:"加一盏聚光灯打在产品上,相机切到 45 度俯视角。"
- 让它截图检查;不满意就直说"光斑太小,把聚光灯角度调宽",它会用 execute_blender_code 微调后再次截图。
- 几轮下来,空白场景里已经站着一个受光的产品和干净的展台;最后补一句"球体换成红色金属",材质立刻切换生效。
小贴士与常见问题
- 用 execute_blender_code 前务必存盘,AI 跑的是真实 Python,误操作没有"撤销"可点 💾
- 首次连接偶尔会失败,直接再发一次指令通常就好,不必重启。
- 报 spawn uvx ENOENT 时,用 which uvx(Windows 用 where uvx)拿到完整路径,填进客户端配置再重启。
- Claude、Cursor 等客户端不要同时启用同一个 blender-mcp 服务,选一个即可。
- 复杂需求拆成小步骤分轮说,比一次性提一大段要求更稳。
链路搭好之后,AI 就常驻在你的 Blender 里:想法直接变模型,参数改完即时看结果。把重复劳动交给它,你只管决定"要什么效果"。
【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考