BlenderMCP 上手指南：让 AI 直接操作 Blender 3D 的 4 步连接方法与排障清单

BlenderMCP 上手指南：让 AI 直接操作 Blender 3D 的 4 步连接方法与排障清单

【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp

建模要在 Blender 里点几百次菜单才能完成的事，BlenderMCP 帮你省掉：这是一个开源插件，让你用自然语言直接操控 Blender 3D——建物体、改材质、截图自查，甚至执行 Python 代码，可接入 Claude、Cursor 等任意大模型客户端。

它是如何工作的：先认识 3 个角色与 2 条连线

整套系统就 3 个角色。你的 AI 客户端（Claude、Cursor 等）只说人话；中间是 MCP 服务端（uvx blender-mcp拉起的进程），像个翻译官，把自然语言指令翻译成 Blender 听得懂的操作单，核心逻辑在 服务端主逻辑；最后住在 Blender 里的单文件插件 插件入口 是真正动手的那只手。前两者之间走标准 MCP 通道；服务端和插件之间则是一条 TCP 专线——插件默认在 9876 端口监听，服务端连上来，命令和结果以 JSON 来回传。所以完整链路是：你说人话 → 翻译官转成指令 → 插件执行 → 截图和结果回传给你核对。

4 步跑通 BlenderMCP：从安装 uv 到第一句建模指令

1. 装好 uv（服务端的启动器），按系统选一条：

   # macOS brew install uv # Linux curl -LsSf https://astral.sh/uv/install.sh | sh

   Windows 用户在 PowerShell 执行：

   powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

   装完把%USERPROFILE%\.local\bin加进 PATH，重启终端。确认成功：终端敲uvx --version，能看到版本号。⚠️ 别用pip install uv凑合，它经常不生成uvx命令。

2. 让 AI 客户端指向服务端。以 Claude 桌面版为例：设置 > 开发者 > 编辑配置，在claude_desktop_config.json里写入：

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

   确认成功：完全退出并重启 Claude，客户端的 MCP 服务列表里 blender 一项显示已连接。

3. 把插件装进 Blender：编辑 > 偏好设置 > 插件 > "安装..."，选中仓库里的addon.py（整个插件就这一个文件），再勾选启用"Interface: Blender MCP"。确认成功：3D 视图按N唤出侧边栏，出现新的 BlenderMCP 标签页。

4. 建立连接并说第一句话：在 BlenderMCP 标签页点Connect to Claude，确认成功是状态显示"运行中"、AI 侧出现锤子图标。然后在对话框输入"创建一个低多边形地牢场景，有火把、石柱和一扇铁门"，视口里物体开始自动出现，就通了。💡 第一条指令偶尔没反应别慌，再发一次即可——首次建立 socket 连接偏慢是正常现象。

按环境对号入座：四类常见接入场景的配置片段

本地标准接入（Blender 与客户端在同一台机器）

第 2 步那份 JSON 就是终态，什么都不用改。适用判断：Blender 和 AI 客户端同机、默认 9876 端口没被占用，直接用它。

Windows + 图形客户端（Cursor、Claude 桌面版等）

Windows 的 GUI 程序不继承终端 PATH，要借道cmd执行：

{ "mcpServers": { "blender": { "command": "cmd", "args": ["/c", "uvx", "blender-mcp"] } } }

适用判断：客户端在 Windows 上、报spawn uvx ENOENT。先试这个写法，不行再用where uvx查出全路径直接填进"command"。改完务必完全退出客户端再打开。

Docker / WSL / 远程机器

原则：Blender 必须监听在 MCP 进程够得着的地方，在配置里加env：

"env": { "BLENDER_HOST": "host.docker.internal", "BLENDER_PORT": "9876" }

适用判断：Blender 在容器里，用host.docker.internal；WSL2 连 Windows 版 Blender，先试BLENDER_HOST=127.0.0.1，不行再换 Windows 主机 IP。截图以 base64 回传，不依赖共享临时目录，远程场景照常用。

纯命令行（Claude Code CLI）

不碰任何 JSON，终端一行注册：

claude mcp add blender uvx blender-mcp

适用判断：你习惯在终端里干活。确认成功：claude mcp list能看到 blender 这条服务。💡 不想用 uv 也可以pipx install blender-mcp && pipx ensurepath，效果等价。

BlenderMCP 连接参数速查：BLENDER_HOST 与 BLENDER_PORT 双侧旋钮

💡 最容易被忽略的两条：① 端口是"两侧各一份"——服务端一份、插件一份，对不上就是典型的连不上；② 别在终端手动跑uvx blender-mcp当常驻进程，它应由 AI 客户端在后台拉起；手动执行会看到"卡住无输出"，那是它在静默等连接，Ctrl-C即可退出。

闭环练习：从一句话到 AI 截图自查的三条递进路线

⚠️ 铁律先说：BlenderMCP 允许 AI 在 Blender 里执行任意 Python（execute_blender_code），等于把场景的钥匙交给了 AI。任何练习开始前，先 Ctrl+S 保存当前文件。

练习一：让 AI 自己建、自己查

• 下发指令："创建一个低多边形地牢：火把、石柱、一扇铁门，加一个相机和一盏关键光"
• 如何验证：别只看它嘴上说"完成"，追加"用视口截图确认一下场景状态"——AI 会调截图工具亲眼看门在哪、光打没打亮
• 还能加一句："火把往左挪一点，光色偏暖一些"——它会基于截图和场景信息修正，而不是瞎改

练习二：用代码路径做精确材质控制

• 下发指令："把选中的立方体变成金色金属，表面保留一点粗糙度"——AI 背后走的是execute_blender_code，新建材质、设 Metallic/Roughness，这是控制材质最细的路径
• 如何验证：视口里应出现金属反射；颜色不满意直接指出"再黄一点"
• 还能加一句："换成拉丝深铜色，改完截图给我确认"

练习三：接入外部资源库组装场景

• 下发指令：先在侧边栏 BlenderMCP 面板勾选 Poly Haven，再让它"用 Poly Haven 的 HDRI、岩石和植被搭一个海滩，HDRI 直接设为世界环境"
• 如何验证：世界背景换成 HDRI 天光，地面有岩石植被，再截图终验
• 还能加一句："去 Sketchfab 搜一把中世纪椅子放在沙滩上，尺寸归一化到 1 米"（需先在插件偏好里填好 API Key）
• 💡 选型口诀：具体物件找 Sketchfab，通用家具和环境贴图找 Poly Haven，都找不到再上生成式模型（Hyper3D Rodin / Hunyuan3D）。

BlenderMCP 连不上时的排障速查表：按踩坑频率排序

以上都不行就上终极三招：断开重连 Blender 插件 → 重启 MCP 客户端 → 把配置里的 blender 服务删掉重新添加。

下一步清单：跑通后依次打勾

• uvx --version有版本号输出
• 客户端配置写入并完全重启客户端
• 插件装好，侧边栏显示"运行中"
• 第一条建模指令跑通，且 AI 做过一次截图自查
• Poly Haven 或 Sketchfab 玩过一次

哪一步卡住了，带上报错原文（注明客户端类型和系统版本）直接来交流，比对着文档猜快得多。

【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp