BlenderMCP一句话指挥 Blender 3D 建模十分钟跑通连接【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp刚装好 BlenderMCP发第一句指令对面要么报连接超时要么一声不吭。BlenderMCP 靠 MCP让 AI 跟外部软件对话的标准管道把 Blender 3D 接上任意大模型自然语言就能指挥建模。卡在连接这一关的读这篇。先想明白它到底怎么工作的BlenderMCP 是两半AI 客户端拉起一个 MCP 服务端Blender 里住着插件一个是传话的一个是干活的——前台和后厨的分工。中间只走一根 TCP 套接字默认端口 9876——端口就是门牌号两边得报同一个号。插件点 Connect 才开始监听相当于拨号接通之前消息全白打。最短路径跑通 BlenderMCP第 1 步装 uv。它是服务端唯一的启动器按系统选一条这只是装工具不碰 Blender# macOS brew install uv # Linux curl -LsSf https://astral.sh/uv/install.sh | shWindows 单独一组在 PowerShell 里执行装完把%USERPROFILE%\.local\bin加进 PATH 并重启终端powershell -c irm https://astral.sh/uv/install.ps1 | iex看到uvx --version有版本输出了这步才算过。⚠️ 别用pip install uv凑合它可能不生成uvx命令。第 2 步把 AI 客户端指向 BlenderMCP。以 Claude 桌面版为例设置 开发者 编辑配置在claude_desktop_config.json里贴上这段——意思是让客户端启动时用uvx拉一个名为blender-mcp的服务由它负责跟 Blender 通信{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }完全退出客户端再重开。算对的标准列表里出现 blender 服务且没有红色报错。第 3 步把 addon.py 拿到本地。整个插件就这一个文件在仓库根目录。clone 下来最省心git clone https://gitcode.com/GitHub_Trending/bl/blender-mcp看到本地多了个 blender-mcp 文件夹里面能找到addon.py就对了。第 4 步装插件并建立连接。Blender 里 编辑 偏好设置 插件 安装…选中addon.py勾选启用Interface: Blender MCP然后回 3D 视图按N唤出侧边栏切到 BlenderMCP 标签点Connect to Claude。算对的标准侧边栏显示服务器运行中客户端对话框里冒出锤子图标——说明 Blender 工具已挂上。第 5 步说出第一句话。发创建一个低多边形地牢一条龙守着一罐金子。算对的标准视口开始自己动起来。 首条指令偶尔没反应是插件首次建 socket 的常见现象原样再发一次就行。跑通之后这几个旋钮先记下来配置项默认值什么场景要改典型值BLENDER_HOSTlocalhostBlender 在 Docker/WSL/远程机器上host.docker.internal、127.0.0.1BLENDER_PORT9876端口被占或换过插件侧端口9877插件侧 Port 属性9876只要动过BLENDER_PORT与环境变量保持同值BLENDER_MCP_DISABLE_TELEMETRY未设置不想发匿名使用统计true注意环境变量写在客户端配置的env段里比如 Cursor 的 Windows 场景端口两边对不上就是你在 5 楼等人人家在 3 楼等你。三个 BlenderMCP 任务难度递增任务一入门一句话建场景 截图自检① 指令创建一个低多边形地牢有火把、石柱和一扇铁门然后用截图确认一下场景状态。 ② 预期物体逐个出现随后 AI 返回一张视口截图并对照检查发现漏了火把会自己补。 ③ 没反应先重发一次首条指令常失败还是不动回侧边栏确认服务器是否还在运行。任务二进阶材质精确控制① 指令把选中的立方体变成金色金属。 ② 预期AI 通过execute_blender_code在 Blender 里执行 Python底层做的事类似这几行你不用手敲知道它干了什么就行mat bpy.data.materials.new(nameGold) mat.use_nodes True mat.node_tree.nodes[Principled BSDF].inputs[Metallic].default_value 1.0看到物体表面泛出金属光泽、AI 回传截图确认就对了。 ③ 没反应让它列出当前选中对象名确认操作对象没选错。⚠️ 这条工具能跑任意代码等于把控制权整个交给 AI——操作前先保存文件这是铁律。任务三高阶调外部资源库组装场景① 指令侧边栏 BlenderMCP 面板勾选Poly Haven然后发用 Poly Haven 的 HDRI、岩石和植被做个海滩氛围。 ② 预期AI 自动搜索并下载贴图、HDRI 和模型HDRI 直接设为世界环境场景立刻有光有景。 ③ 没反应确认侧边栏勾选已生效并重启连接Sketchfab、Hyper3D Rodin、Hunyuan3D 这几条管道要先在插件偏好里填好 API Key如BLENDERMCP_SKETCHFAB_API_KEY才可用。对号入座5 个高频故障一、客户端直接起不来报spawn uvx ENOENT现象图形界面客户端Claude、Cursor里 blender 服务显示启动失败。 根因GUI 程序不继承终端 PATH找不到uvx。 解法macOS/Linux 跑which uvxWindows 跑where uvx把返回的全路径填进配置的commandWindows 也可以整体换成command: cmd, args: [/c, uvx, blender-mcp]。改完配置必须完全退出客户端再开。二、能启动但一直连不上 Blender现象AI 回Could not connect to Blender或持续连接超时。 根因插件端没在听或主机/端口两边对不上。 解法按序查——① 侧边栏确认服务器运行中② 核对BLENDER_PORT与插件面板端口同值③ 防火墙放行 9876④ 确认是带界面的 Blender 启动的blender -b后台模式下 socket 和视口工具全都用不了。三、命令卡很久、超时或响应错乱现象简单指令也要等一两分钟或流式输出串行。 根因单次 socket 超时是 180 秒任务太复杂会撞线多个客户端共用一条 socket 也会抢端口。 解法大任务拆成小指令一步步喂同一时间只保留一个客户端挂着 BlenderMCP 服务。习惯在终端手敲uvx blender-mcp的注意它应该由客户端后台拉起手动跑时卡住无输出是在静默等待按Ctrl-C退出即可不是死机。四、Python 版本冲突uvx 编译报错现象conda/pyenv 机器上报依赖错Apple Silicon 上被拉去编 x86_64 的包cryptography wheel 报错。 解法配置里钉死版本加args: [--python, 3.11, blender-mcp]和env: { UV_PYTHON_PREFERENCE: only-managed }Apple Silicon 试--python, 3.11-aarch64。老版本怪病用uv cache clean blender-mcp uvx --refresh blender-mcp清缓存刷新。五、以上都试过还是不通兜底三板斧重启 Blender 里的插件、重启 MCP 客户端、把配置里的 blender 服务删掉重新添加。再不行检查插件偏好里的遥测选项与BLENDER_MCP_DISABLE_TELEMETRY是否互相打架然后从头过一遍最短路径五步。跑通之后往哪走养成操作 → 截图验证 → 修正的闭环多追一句用截图确认一下让 AI 边做边自查想让服务端安静配置env里加BLENDER_MCP_DISABLE_TELEMETRY: true或在 Blender 插件偏好里取消遥测勾选看源码入门src/blender_mcp/server.py 里的BlenderConnection展示了锁 socket 流如何保证命令不乱序addon.py 是面板注册和端口逻辑的落点升级插件下载最新addon.py替换再删掉重加一次客户端里的 MCP 服务验证清单每项都能直接跑出结果☐ 终端跑uvx --version有版本号输出☐ 客户端配置列表里 blender 服务无红色报错☐ Blender 侧边栏 BlenderMCP 面板显示服务器运行中☐ 发建物体指令视口里多出新对象☐ 发截图确认场景AI 回传一张视口截图☐ 勾选 Poly Haven 后下载到一个资产贴图或 HDRI成功【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考