MCP for Blender 安装指南从装好插件到视口出东西【免费下载链接】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 ENOENT。问题几乎不在你而在链路里某一环没对上。MCP for Blender 是 Siddharth Ahuja 做的第三方开源插件非 Blender 基金会官方项目把你的大模型客户端接到 Blender用自然语言建物体、改材质、跑 Python、从素材库拉资源。用过 Blender 但没碰过 MCP 的人读这篇就能动手。它能替你干什么六项能力一览建物体立方体、石柱、整片低多边形场景改材质换颜色、换金属度、换粗糙度跑代码让 AI 直接写 bpy 代码改场景查场景问视口里有什么逐个列出拉素材Poly Haven 的 HDRI 和模型免密钥下载导交接场景或选中物导出 GLB / FBX本文带你走通最短路径装好三个零件接上线打出第一条让视口出东西的指令。三个零件先装再谈接线顺序记一句话客户端是你的嘴服务端是调度台插件是 Blender 里的执行者。客户端Claude Desktop、Cursor、Codex 任选其一装什么任意一个支持 MCP 的客户端即可一个就够同一时间别用两个客户端挂同一个服务。怎么装图形界面客户端在设置里贴配置即可配置 JSON 见下一节命令行客户端一条命令注册# Codex codex mcp add blender -- uvx mcp-for-blender # Claude Code claude mcp add blender uvx mcp-for-blender # Claude Desktop / Cursor在 Settings → MCP 里贴 JSON怎么确认装对了彻底重开客户端工具列表里出现 blender 条目条目旁有锤子图标就算过。⚠️ 改完配置必须彻底退出再重开Windows 从系统托盘退macOS 按 CmdQ因为配置文件只在启动那一刻读一次存盘再多次也不生效。中间服务端mcp-for-blender靠 uvx 一键拉起装什么服务端包mcp-for-blender当前版本 2.1.3旧包名 blender-mcp 能跑但新装请用新名。它不需要单独安装uvx会在客户端启动时自动拉取运行你真正要装的是启动器 uv。怎么装# macOS: brew install uv # Linux: curl -LsSf https://astral.sh/uv/install.sh | sh # Windows: powershell -c irm https://astral.sh/uv/install.ps1 | iex怎么确认装对了终端敲uvx --version看到版本号输出就算过。⚠️ 别用pip install uv凑数它经常不生成uvx命令把 uv 藏进客户端看不到的环境里下一步客户端会直接报spawn uvx ENOENT。Blender 插件单文件 addon.py一条命令装好装什么Interface: MCP for Blender插件整个插件就是仓库根目录的addon.py一个文件装好后它是 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 标签页Port 输入框默认 9876就算过。⚠️ 第一条指令偶尔超时就重发一次插件是首条命令到达时才真正建立 socket 通道第一次失败是已知行为不是故障。接线让三方握上手[AI 客户端 Claude/Cursor] ⇄stdio⇄ [MCP 服务端 mcp-for-blender] ⇄TCP:9876⇄ [Blender 插件 addon.py]零件你可以把它理解成一句话职责AI 客户端下单的人你说话的地方指令从这里出发MCP 服务端前台调度把自然语言拆成 JSON 指令转给 Blender端口 9876门牌号两端号码一致才找得到人Blender 插件待命的接线员在 Blender 内部真正执行建模动作在哪改打开 Claude Desktop 的设置 → 开发者 → 编辑配置把下面整段贴进claude_desktop_config.jsonCursor、VS Code、Codex 同理贴到各自的 MCP 配置位置。{ mcpServers: { blender: { command: uvx, args: [mcp-for-blender] } } }改完必须彻底退出客户端再重开——它只在启动那一刻读一次这个文件。MCP 协议就是软件之间的普通话客户端和服务端都会说才接得上话。命令和回执都是 JSON一条最小指令长这样{ type: create_object, params: { type: CUBE } }插件执行后回status: success加结果出错则status: error并带message。你和视口之间所有东西都是它的载体。五个马上能玩的场景⚡ 一句话建低多边形地牢确认侧边栏面板显示 Connected on port 9876没连上就点 Connect to MCP server。发送创建一个低多边形地牢火把、石柱、一扇铁门。首条指令没反应就原样重发一次。你会看到视口里物体逐个冒出来火把、石柱、铁门齐了。这一关验证的是打字到视口的整条命令回路真的通了。 让 AI 截图自查再修正发送用视口截图确认一下当前场景状态。哪里不对就指出把火把往左挪一点。让它再截一张图核对。你会看到AI 先回一张视口截图并描述场景内容听完你的意见再动手改完再截图验证。这一关验证的是操作 → 截图 → 修正闭环建模从盲改变成改完回头看一眼。⚡ 把立方体变成金色金属跑任意代码先保存当前 .blend 文件。execute_blender_code能执行任意 Python等于把 Blender 控制权整个交给 AI——动手前保存是铁律翻车时唯一的后悔药。让 AI 新建一个立方体。发送把这个立方体变成金色金属材质粗糙度 0.2。你会看到材质面板里 Principled BSDF 节点 Metallic 为 1、Roughness 为 0.2。这一关验证的是工具清单之外 AI 还能直接写 bpy自由度没有上限风险也没有上限。 Poly Haven 管道铺一个海滩侧边栏勾选Poly Haven复选框免密钥、无账号CC0 免费素材。发送用 Poly Haven 的 HDRI、岩石和植被做个海滩氛围。素材下载走 Blender 主线程UI 会卡到下载完成离镜头远的素材只要求 1k 或 2k别贪 4k。你会看到世界环境变成 HDRI 光照场景里多了岩石和植被物体。这一关验证的是内置素材管道搜索、下载、应用一条龙AI 不用碰任何网页。 把场景导出成 GLB追加把当前场景导出为 GLB。AI 会调用export_scene也可以只导出选中物体或指定名称的物体。你会看到得到一个.glb文件双击能直接打开丢给下游软件照样用。这一关验证的是Blender 不是孤岛场景能通过标准格式流到别的工具里。翻车急救箱四张症状卡片症状一客户端起不来报 spawn 错误现象failed to start: spawn uvx ENOENT诊断图形界面客户端不继承终端的 PATH它那边根本没有 uvx——不是 Blender 的事。修复① 敲which uvxWindows 用where uvx拿完整路径 ② 配置里 command 换成该绝对路径 ③ 彻底退出客户端再重开兜底重装 uvuvx --version重新确认。症状二连接超时够不到 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诊断服务端在 9876 端口上够不到插件或 Blender 是无界面模式blender -b下命令永远执行不了。修复① 确认面板不是 Not connected ② 核对面板 Port 与 BLENDER_PORT 一致 ③ 确认 Blender 带界面启动兜底侧边栏 Disconnect 再重连端口再核一遍。症状三简单指令正常复杂请求卡住现象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诊断复杂请求超过了单次 socket 请求的 180 秒上限或者两个客户端共用一条连接串了线。修复① 大任务拆成小指令分步发 ② 同一时间只留一个客户端挂服务 ③ 侧边栏断开重连重建连接兜底继续简化请求或者重启 Blender。症状四conda / pyenv 环境冲突现象典型报错× Failed to install mcp-for-blender no wheels found for this Python version, build from source failed诊断uv 选到了 conda / pyenv 里的 Python 或过新的 CPython没有现成 wheel现场编译翻车。修复① 配置 args 加 --python, 3.11 ② env 加 UV_PYTHON_PREFERENCE: only-managed ③ 清 uv 缓存后重启客户端兜底uvx --refresh mcp-for-blender强制重新拉取。终极三板斧基本覆盖九成幽灵问题重启 Blender 里的插件Disconnect → Connect to MCP server彻底重启 MCP 客户端把配置里的 blender 服务删掉重新添加。调参速查表不改也能跑什么都不改时BLENDER_HOST默认localhostBLENDER_PORT默认 9876单次 socket 请求超时上限 180 秒遥测默认只发一条最小匿名用量记录你的提示词、代码、截图不收集除非你明确勾选同意。参数默认值什么时候需要改改完怎么验证BLENDER_HOSTlocalhostMCP 服务端跑在 Docker 或另一台机器截图指令正常返回截图走 base64不依赖共享目录BLENDER_PORT或--port98769876 被占或同时开两个 Blender 实例面板显示 Connected on port 9877指令有回音Python 版本--pythonuv 自选机器上有 conda / pyenv或新 CPython 无现成 wheel客户端不再刷编译错误锤子图标正常出现DISABLE_TELEMETRY未设置最小匿名记录开连一条匿名用量记录都不想发重启后无任何上报功能不受影响Docker 网络模式bridge 镜像默认BLENDER_HOSThost.docker.internalLinux 上该域名不存在改--networkhost加BLENDER_HOSTlocalhost连接正常最常用的两行内联示例改端口args: [mcp-for-blender, --port, 9877]CLI 参数优先于环境变量关遥测export DISABLE_TELEMETRYtrue。往源码走三步server.py锁加 socket 流命令不乱序addon.py面板、端口、命令路由全在这README.md环境变量与排错的官方依据收尾你现在手上有一条跑通的链路客户端打字Blender 视口动手中间隔着 9876 这一个门牌号。卡住了就带三样东西来问报错原文、系统版本、客户端类型。链路已经接通接下来的场景该你发挥了。【免费下载链接】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），仅供参考