BlenderMCP 快速入门:用自然语言驱动 Blender 3D 建模与场景控制
【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp
在 Blender 里做场景时,"把车改成红色金属材质"或"给场景加个摄影棚灯光"这类小事,往往要你翻菜单、找参数逐项改。BlenderMCP 让你把这些指令直接用文字丢给 AI 助手(Claude、Cursor 等),3D 场景会实时按指令变化,不用离开聊天窗口。
它的原理并不神秘:AI 客户端一侧跑一个 MCP 服务,Blender 内部装一个插件在本地端口监听,两边通过 socket 通信。连上之后,你在对话里敲的每句话都会被转成对 Blender 的实际调用。
🧊 BlenderMCP 是什么
BlenderMCP 是一个开源社区插件,把 Blender 3D 连接到任意大语言模型,解决"反复做重复性 3D 操作"的痛点:建物体、调位置、改材质、查场景状态,都可以用打字的方式完成。适合两类人:想用 AI 辅助但没写过 Python 的 3D 新手,以及想把场景搭建中机械的部分交给自动化的成熟用户。
🎨 它能帮你做什么
用自然语言指令操控 3D 物体与材质
在聊天框输入"创建一个低多边形地牢,门口站一只守卫金子的龙",服务会把指令拆成 Blender 调用:创建物体、移动、缩放、删除、改材质颜色。所有工具定义集中在 src/blender_mcp/server.py,想看它到底能执行哪些操作,读这一个文件就够了。
实时查看场景状态与视口截图
改场景前,你可以先问 AI"现在场景里有什么",它会返回物体、灯光、相机的完整清单。更进一步,它能截当前视口的图返回给模型,让 AI 基于"看到的画面"而不是猜测来调整镜头或布光。
直接下载材质与模型资产
集成了 Poly Haven 和 Sketchfab,可以让 AI 替你搜索并下载 HDRI 环境、贴图或现成 3D 模型进场景。如果需要的模型不存在,还能用 Hyper3D Rodin 或 Hunyuan3D 从一段文字或一张图直接生成 3D 资产。
在 Blender 内执行自定义 Python
超出内置工具范围的操作,它能直接在 Blender 环境里跑 Python 代码,灵活性接近你自己写脚本。注意两点:它执行的是任意代码,使用前先保存工程;这类复杂请求建议拆成小步骤依次执行,避免超时。
🚀 三步跑起来
- 拿到代码。需要 Blender 3.0 以上、Python 3.10 以上,并用包管理器装好 uv(不要用 pip 装 uv,可能没有
uvx命令):
git clone https://gitcode.com/GitHub_Trending/bl/blender-mcp- 在 AI 客户端里注册 MCP 服务。打开 Claude Desktop、Cursor 或 VS Code 的 MCP 配置文件(如
claude_desktop_config.json),加一段:
{ "mcpServers": { "blender": { "command": "uvx", "args": ["blender-mcp"] } } }保存后客户端会自己通过 uvx 启动服务,你不需要手动跑任何命令。
- 装插件并连接。在 Blender 里进
Edit > Preferences > Add-ons > Install,选仓库中的addon.py,启用 "Interface: Blender MCP"。然后按N打开 3D 视图侧边栏,切到 BlenderMCP 标签页,点Connect to Claude,连上即可开始发指令。
❓ 常见问题
客户端报 "spawn uvx ENOENT" 怎么办?图形界面客户端不继承终端的 PATH。用which uvx(Windows 用where uvx)找到完整路径,把它填进配置的 command 字段,改完配置后完全重启客户端。
需要自己手动运行 uvx blender-mcp 吗?不需要。MCP 服务由 AI 客户端自动拉起,手动跑反而可能冲突。连接失败时先检查 Blender 侧边栏里插件的连接状态,并留意第一条指令有时需要重发一次。
复杂场景指令总是超时?把大请求拆成若干个小提示词,按顺序执行。凡是会执行自定义 Python 代码的操作,动手前先保存文件,最坏情况重启客户端和 Blender 里的服务即可恢复。
📚 进阶资源
- 功能总表、示例提示词与故障排查:README.md
- Blender 插件本体(连接面板、API 密钥配置):addon.py
- MCP 工具定义与通信实现:src/blender_mcp/server.py
- 版本与依赖声明(当前 1.8.4,仅依赖 mcp 与 httpx):pyproject.toml
- 遥测与隐私说明,以及如何关闭统计上报:SECURITY.md
BlenderMCP 把 Blender 变成了一个任何支持 MCP 的 AI 客户端都能直接调用的 3D 工具。等你装好插件,不妨从一句"创建一个球体,把它改成红色"开始,感受一下用聊天搭场景是什么体验。
【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考