MCP for Blender：装通这个 MCP 插件，让 AI 用自然语言替你建模

MCP for Blender装通这个 MCP 插件让 AI 用自然语言替你建模【免费下载链接】mcp-for-blenderCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/mcp-for-blender在 Blender 里建一座低多边形地牢几根石柱、一把火把、一扇铁门。 装完 MCP for Blender 这个开源 MCP 插件之后这句话可以直接打给 AI。它解决的问题很具体让任意大模型直接驱动 Blender——建物体、改材质、截视口图、跑 Python 代码你只负责说话。组件清单3 个部件各跑在哪组件跑在哪你需要装吗插件 addon.pyBlender 内部要装单文件仓库根目录就有MCP 服务端你自己的电脑一条命令拉起免手动编译大模型客户端你自己的设备用现成的Claude Desktop、Cursor 都行整条链路只有 3 个活动部件。只想用不想懂的人读到「验货三关」一节就能收工。一句话怎么走到 3D 视口你的话从大模型客户端出发经过 MCP 服务端变成一条 JSON 命令到 Blender 里的插件被执行结果原路返回。命令和结果都是 JSON{ type: get_viewport_screenshot }这就是中间流转的最小单元执行完之后插件回一个带 status 和 result 的 JSON模型再把它翻译成你看得懂的描述。整条路只认一个端口号——9876——两端写同一个号命令才到得了跟快递只认门牌号是一个道理。先装 uv再写配置最后把插件塞进 Blender先装 uv。它是拉起服务端的启动器各系统命令并列如下系统安装命令macOSbrew install uvLinuxcurl -LsSf https://astral.sh/uv/install.sh \| shWindowspowershell -c irm https://astral.sh/uv/install.ps1 \| iex⚠️ 别用 pip install uv 凑数它经常不生成 uvx 命令客户端会直接报找不到命令。✅ 终端敲 uvx --version能看到版本号就算过。再写客户端配置。打开 Claude Desktop 的 设置 开发者 编辑配置在 claude_desktop_config.json 里贴入{ mcpServers: { blender: { command: uvx, args: [mcp-for-blender] } } }这段配置的作用客户端一启动就拉起 uvx mcp-for-blender客户端退出它就停。同一时间只挂一个客户端——Cursor 和 Claude Desktop 都连着会抢同一条连接。⚠️ 改完配置必须完全退出客户端再重启它只在启动那一刻读一次这个文件。✅ 重启后 blender 条目出现在工具列表里就算过。最后装插件。省事的方式是一条命令把插件直接拷进 Blender 的插件目录uvx mcp-for-blender install-addon想自己挑文件就克隆仓库用根目录的 addon.pygit clone https://gitcode.com/GitHub_Trending/bl/mcp-for-blender然后在 Blender3.0里编辑 偏好设置 插件 安装…选中 addon.py勾选启用Interface: MCP for Blender。✅ 3D 视图按 N 键侧边栏出现 MCP for Blender 标签就算过。在标签里点Start MCP Server链路就通了。回客户端发第一句创建一个低多边形地牢场景。✅ 视口里开始冒出物体Claude 里 blender 条目旁出现锤子图标就算全通。第一条指令偶尔没反应直接重发一次就行。改端口、换主机、关遥测一张速查表症状参数改哪9876 端口被占BLENDER_PORT客户端配置 env同时改插件面板端口Blender 在 Docker、WSL 或远程机器BLENDER_HOST客户端配置 envuvx 编译报错机器上有 conda/pyenv--python 3.11 UV_PYTHON_PREFERENCE客户端配置 args 和 env不想上报匿名统计DISABLE_TELEMETRY客户端配置 env想让脚本先过审查再执行BLENDER_MCP_SAFE_MODE客户端配置 env默认行为一句话什么都不改时BLENDER_HOST 是 localhostBLENDER_PORT 是 9876单条命令等 Blender 回应的上限是 180 秒。BLENDER_PORT管服务端找 Blender 的端口号客户端配置的 env 里加一行插件面板里的端口同步改成同一个数字env: { BLENDER_PORT: 9877 }⚠️ 两边必须一致只改一边服务端会对着一个没人监听的端口空转永远连不上。也支持命令行参数优先级高于环境变量适合并排开多个 Blender 实例uvx mcp-for-blender --port 9877BLENDER_HOST管 Blender 跑在哪台机器上Docker Desktop 在 macOS 和 Windows 上镜像默认就是 host.docker.internal容器里的服务端直接够得到宿主机的 Blender。Linux 的容器里没有这个主机名得给容器加 --networkhost再设 BLENDER_HOSTlocalhost。WSL2 连 Windows 侧 Blender先试 127.0.0.1不通再换 Windows 主机 IP。--python 3.11管服务端用哪个 Python 跑机器上有 conda 或 pyenv 时uv 可能挑中一个让依赖装不上的解释器。在 blender 条目里钉死版本args: [--python, 3.11, mcp-for-blender], env: { UV_PYTHON_PREFERENCE: only-managed }3.11 满足包的 3.10 要求only-managed 让 uv 只用自己管理的解释器不碰系统里现成的 Python。如果之前失败的尝试还在反复重放清缓存再刷新uv cache clean mcp-for-blender blender-mcp uvx --refresh mcp-for-blenderDISABLE_TELEMETRY管要不要上报匿名统计默认只发一条极简匿名记录随机安装 ID、会话 ID、工具名、成败、耗时、版本、操作系统、时间戳提示词、生成的代码、截图、场景数据都不在其中除非你主动勾选。想一条都不发配置里加env: { DISABLE_TELEMETRY: true }BLENDER_MCP_SAFE_MODE管脚本要不要先审查再执行默认 AI 可以跑任意 Python。设成 1 之后每段脚本先过一遍校验直接读写文件、启动别的程序、连网络这类危险代码会被拦下拦截原因退回给 AI让它换写法重试正常建模、渲染、保存不受影响。验货三关搭个场景、换个材质、拉套资源场景一建个地牢再让 AI 自查你说创建一个低多边形地牢火把、石柱、一扇铁门再追一句截个视口图看看它做摆出全部物体再基于截图向你描述场景现状你看视口里物体齐全你指哪它改哪——哪不对就说把火把往左挪一点它改完再截图描述和画面能对上就算成翻车了第一条指令没反应重发一次即可场景二跑任意 Python把立方体变金色金属你说把这个立方体改成金色金属材质粗糙度 0.2它做执行 bpy 代码新建 Principled BSDF 节点并接线你看材质面板里出现 Principled BSDF 节点Metallic 是 1Roughness 是 0.2翻车了⚠️ 这个工具能跑任意代码等于把 Blender 的控制权整个交给 AI——跑之前先存文件这是硬规矩场景三用 Poly Haven 资源管道搭个氛围你先侧边栏勾上 Poly Haven 复选框配置到此为止你说用阴天午后的 HDRI 给场景打光再给墙贴一块锈蚀金属纹理它做按语义搜资产、下载、应用搜的是意图而不是关键词你看世界环境节点里挂上 HDRI墙上纹理生效翻车了下载期间界面卡死——资产在主线程下载传输完才恢复响应离镜头不近的资产就让它下 1k 或 2k急诊室四个症状对号入座你看到什么大概率原因三十秒动作还没好客户端起不来报 spawn uvx ENOENTGUI 启动的客户端继承不到终端 PATHwhich uvxWindows 用 where uvx拿完整路径填进 commandWindows 也可写 command: cmd, args: [/c, uvx, mcp-for-blender]完全退出客户端重启服务起了连 Blender 一直超时插件没运行、两边端口不一致、或 Blender 是后台模式看侧边栏是否显示运行中核对两边端口确认 Blender 带界面启动blender -b 后台模式下命令永远不执行侧边栏断开重连端口再核一遍简单指令正常大任务超时单条命令撞上 180 秒上限大任务拆成小指令分批发重启 Blender响应错乱像串线Cursor 和 Claude Desktop 同时挂着同一时间只留一个 MCP 客户端断开重连重建连接通用重启序列按顺序来Blender 侧边栏断开 → 重连。完全退出 MCP 客户端再开还不行把配置里的 blender 服务删掉重新添加。收尾想继续挖点这三处到这里从对话框到 3D 视口的整条链路已经通了今天到此为止。src/blender_mcp/server.py看 BlenderConnection 类锁加 socket 流怎么保证命令不乱序addon.py看插件怎么注册侧边栏面板端口默认值 9876 在哪README.mdTroubleshooting 一节官方排错清单和上面的急诊表对号下一步让 AI 用截图自查一遍刚建的场景指出问题让它改。卡住了把报错原文、系统版本、客户端类型三样贴出来。【免费下载链接】mcp-for-blenderCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/mcp-for-blender创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考