MCP for Blender 安装一次跑通让 AI 摆好第一组场景【免费下载链接】mcp-for-blenderCommunity plugin to control Blender 3D with any LLM of your choice. Not affiliated with the official Blender Foundation.项目地址: https://gitcode.com/GitHub_Trending/bl/mcp-for-blender你在客户端敲下建一个低多边形小屋回来一句spawn uvx ENOENTBlender 侧边栏却还挂着Not connected指令石沉大海。问题几乎都不在你而在链路某一环没对上。MCP for Blender 让你用任意大模型通过自然语言直接操作 Blender 建模本文带你完成 MCP for Blender 安装装好 uv 与服务端、接上客户端、插件入位最终视口里真实冒出小木屋、金属立方体和海滩 HDRI。动手前环境与前置自检检查项怎么查通过标准依赖工具 uv 是否就位终端跑uvx --version打印出版本号端口9876是否空闲macOS/Linuxlsof -i :9876Windowsnetstat -ano \| findstr 9876无占用输出Blender 版本与启动方式菜单栏Blender → About Blender3.0且是带图形界面启动MCP 客户端客户端Settings里看 MCP 页面最新版且当前只留一个客户端挂此服务旧配置残留客户端 MCP 配置里搜blender没有重复或写坏的blender条目⚠️ 同一时间只保留一个客户端挂这个服务两个客户端共用一条 socket 会让响应错乱。全部打勾再往下否则后面积木全塌。接线把三端串成一条活链路MCP for Blender 安装用 uvx 拉起 MCP 服务这一端要达成客户端一启动就能自动拉起 MCP 服务端而拉起它的钥匙是uvx。# macOS brew install uv # Linux curl -LsSf https://astral.sh/uv/install.sh | sh# Windows装完把 %USERPROFILE%\.local\bin 加进 PATH再重开终端 powershell -c irm https://astral.sh/uv/install.ps1 | iex⚠️ 别用pip install uv凑数它经常不生成uvx命令还会把 uv 藏进客户端看不到的环境里。确认信号终端跑uvx --version打印出版本号。把插件装进 Blender这一端要达成Blender 里有一个常驻的执行端指令进来就能落到视口。uvx mcp-for-blender install-addon命令会把插件复制进 Blender 的 addons 目录存为blender_mcp.py旧文件留.bak备份并打印落盘位置。命令找不到你的 Blender 就手动装克隆仓库git clone https://gitcode.com/GitHub_Trending/bl/mcp-for-blender在 Blender 里编辑 → 偏好设置 → 插件 → 安装…选中根目录的addon.py再启用Interface: MCP for Blender。确认信号3D 视口按N键侧边栏出现MCP for Blender标签页。把客户端挂上配置这一端要达成客户端启动那一刻自动把服务端拉起来。Claude Desktop 走设置 → 开发者 → 编辑配置在claude_desktop_config.json里贴入Cursor / VS Code / Codex 同理都是一条uvx命令拉起服务{ mcpServers: { blender: { command: uvx, args: [mcp-for-blender] } } }⚠️ 改完配置必须彻底退出客户端再重开——它只在启动那一刻读一次这个文件。确认信号重启后工具列表出现 blender 条目旁边有锤子图标。[AI 客户端] ⇄stdio⇄ [MCP 服务端 mcp-for-blender] ⇄TCP:9876⇄ [Blender 插件 addon.py]组件片场角色一句话职责AI 客户端导演你说话的地方负责喊搭个景MCP 服务端场记把自然语言记成一条条 JSON 指令转给片场端口9876对讲机频道两端号码一致才喊得上话Blender 插件搭景组在视口里真正挪物体、调材质第一次让它干真活从单物体到导出 GLB开工前在侧边栏MCP for Blender标签里按需勾选资源库Poly Haven 免密钥Port 保持9876点Connect to MCP server。面板从Not connected变成Connected on port 9876即链路通了。任务 1一句话建出小木屋完成画面Outliner 里多出 CUBE 系列物体视口里小屋成型。发给 AI 的原话创建一个低多边形小木屋带一个石炉和一扇门摆成一个小场景。核对点Outliner按N→ Outliner逐个数出新增物体视口里小屋、炉子、门各就各位。为什么能成每条指令被转成 JSON 命令发给插件视口即时更新。任务 2把立方体改成金色金属完成画面视口里立方体呈现金属反光材质面板节点参数达标。发给 AI 的原话把场景里新建的那个立方体改成金色金属材质Metallic 设为 1.0Roughness 设为 0.2。核对点属性编辑器材质属性 → 新建Principled BSDF 里 Metallic 等于1.0、Roughness 等于0.2。⚠️ AI 会直接在你的文件里跑bpy代码动手前先保存文件——这是唯一的后悔药。为什么能成代码在bpy层直接执行节点参数精确落值。任务 3Poly Haven 铺海滩再导出 GLB完成画面世界节点挂上 HDRI场景多出岩石与植被手里拿到一个能打开的.glb。发给 AI 的原话用 Poly Haven 的 HDRI 天空、一块岩石和一点植被给当前场景铺一个海滩氛围。核对无误后追加把当前场景导出为 GLB。核对点Outliner 出现岩石与植被物体世界环境节点挂上 HDRI导出的.glb能拖进浏览器或 Blender 打开。为什么能成内置资源管道负责搜索、下载、应用导出走export_scene。上一帧的产出就是下一帧的素材小木屋、金属立方体、海滩 HDRI接下来都可以继续叠加。默认行为与可改项对照配置项默认值改它的典型场景改完如何验证BLENDER_HOSTlocalhost服务端跑在别的机器/容器里改后指令有回音BLENDER_PORT9876端口被占、两个 Blender 并排跑面板显示对应端口号--portCLI 参数无覆盖BLENDER_PORT客户端配置里直接钉端口多实例并排面板Connected on port …DISABLE_TELEMETRY关收一条最小匿名用量记录一条都不想发服务端无任何上报改端口两端号码必须一致触发条件9876被别的程序占了或你同时开两个 Blender 实例。改法客户端配置env里加BLENDER_PORT: 9877或args写[mcp-for-blender, --port, 9877]参数优先于环境变量插件面板 Port 同步改号。验证两边都重连面板显示Connected on port 9877。⚠️ 只改一边等于往一个已注销的频道喊话永远没人应。跨机器服务端进 Docker触发条件MCP 服务端跑在容器或另一台机器Blender 留在本机。改法Linux 上host.docker.internal不存在改用 host 网络macOS/Windows 的 Docker Desktop 默认BLENDER_HOSThost.docker.internal即可直达宿主机的 Blender{ command: docker, args: [run, -i, --rm, --networkhost, -e, BLENDER_HOSTlocalhost, mcp-for-blender] }验证视口截图能正常回传截图走 base64不依赖共享目录远程也能用。⚠️ 插件的 socket 目前没有认证和加密任何够得到这个端口的人都能在你的 Blender 里跑 Python——跨机器保持localhost加 SSH 隧道别把端口直接暴露到网络。关遥测一条都不想发触发条件连默认那条最小匿名用量记录都拒绝。改法export DISABLE_TELEMETRYtrue或写进客户端配置的envDISABLE_TELEMETRY: true。验证服务端不再有任何上报功能不受影响。出问题了按顺序查你看到的现象定位方向处置入口客户端起不来报 spawn 错误客户端找不到uvx查 PATH改绝对路径服务起来了连 Blender 一直超时插件没连上或端口不对看面板状态核端口简单指令正常、复杂请求超时任务太大或多客户端串线拆任务留一个客户端修好 Python 后仍反复失败uv 缓存重放旧结果清缓存重拉指令永远石沉大海Blender 是后台模式带 GUI 启动客户端起不来spawn uvx ENOENT报错原文CtrlF 对号入座failed to start: spawn uvx ENOENT终端跑which uvxmacOS/Linux或where uvxWindows→ 预期打印出完整路径把绝对路径填进commandWindows 也可写command: cmd, args: [/c, uvx, mcp-for-blender]→ 预期配置指向真实存在的可执行文件彻底退出客户端再重启Windows 从系统托盘退出→ 预期工具列表出现 blender 条目兜底重装 uvuvx --version重新确认。走到这步还没解决带报错原文 系统版本 客户端名称去 issue 区。服务起来了但连 Blender 一直超时报错原文Timeout waiting for Blender response - try simplifying your request. If Blender is running headless (blender -b), commands never execute; run Blender with a GUI or via xvfb-run -a blender instead回 Blender 侧边栏看面板是否Connected on port …→ 预期不是Not connected核对插件面板 Port 与BLENDER_PORT/--port→ 预期两边数字一致确认 Blender 是带界面启动的blender -b后台模式下命令永远执行不了→ 预期指令有回音侧边栏 Disconnect 再 Connect端口再核一遍 → 预期连接状态保持兜底重启 Blender 本身。走到这步还没解决带报错原文 系统版本 客户端名称去 issue 区。简单指令正常复杂请求超时或卡住触发条件大任务单条 socket 请求超过 180 秒上限或两个客户端挤一条连接。把大任务拆成小指令分步发 → 预期每步都有回执检查是否 Cursor 和 Claude 同时挂着服务 → 预期只留一个客户端侧边栏断开重连重建连接 → 预期后续命令恢复兜底继续简化请求或重启 Blender。走到这步还没解决带报错原文 系统版本 客户端名称去 issue 区。修好 Python 版本后仍然反复失败触发条件修好 conda / pyenv 冲突后旧的编译失败被 uv 缓存原样重放。跑uv cache clean mcp-for-blender blender-mcp uvx --refresh mcp-for-blender→ 预期缓存被清、依赖重新拉取重启客户端看工具列表 → 预期不再刷编译错误锤子图标出现兜底把配置里的 blender 服务删掉重新添加。走到这步还没解决带报错原文 系统版本 客户端名称去 issue 区。源码地图与今日清单三个值得继续挖的入口src/blender_mcp/server.pyBlenderConnection类锁加 socket 流保证命令不乱序addon.py面板、端口逻辑和按type路由的命令分发全在这一个文件里README.mdEnvironment Variables 与 Troubleshooting 两节官方排错的最终依据今日清单终端验证uvx --version有版本号输出写好客户端 MCP 配置并彻底重启确认锤子图标出现uvx mcp-for-blender install-addon装好插件面板显示Connected on port 9876让 AI 建一个小场景并用视口截图自查一轮勾选 Poly Haven完成一次 HDRI 或模型导入导出你的第一个产出export_scene出 GLB 或截图存档哪一步卡住带三样来——报错原文、系统版本、客户端名称。三样齐定位最快。【免费下载链接】mcp-for-blenderCommunity plugin to control Blender 3D with any LLM of your choice. Not affiliated with the official Blender Foundation.项目地址: https://gitcode.com/GitHub_Trending/bl/mcp-for-blender创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考