尧图网站建设 
MCP for Blender 完整安装教程从零配置到 10 分钟让 AI 在 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你在 AI 客户端的对话框里敲下建一个低多边形小屋转了十几秒回你一句failed to start: spawn uvx ENOENT换个客户端再试Blender 侧边栏的状态行还卡在 Not connected 一动不动。问题几乎都不在你而是链路里某一环没对上。MCP for Blender 是一个开源插件它让任意大模型Claude、Cursor 里的模型都行通过自然语言直接操作 Blender——建物体、改材质、跑 Python、拉素材。读完这篇你会装通整条链路并且让第一条指令真正在视口里造出东西。30 秒看懂这条链路先看清三根线再动手[AI 客户端 Claude/Cursor/Codex] ⇅ stdioMCP 协议 [MCP 服务端 mcp-for-blender由 uvx 拉起] ⇅ TCP 端口 9876JSON over socket [Blender 插件 addon.pysocket 服务器] ↓ bpy 真正执行建模动作组件你可以把它理解成一句话职责AI 客户端下单的人你说话的地方MCP 服务端前台调度把自然语言拆成 JSON 指令转给 Blender端口9876门牌号两端号码一致才找得到人Blender 插件待命的接线员在 Blender 内部真正执行动作命令和回执都是 JSON。一条最小请求长这样{ type: create_object, params: { type: CUBE } }插件执行后回{ status: success, result: ... }出错则status为error并带message。这就是你和视口之间所有东西的载体。从零到连通第 1 步装 uv拿到 uvx 启动器目标系统里有一个能随时拉起服务端的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打印出版本号才算过关。第 2 步把客户端配置指到服务上目标客户端一启动就自动拉起 MCP 服务端。以 Claude 桌面版为例设置 开发者 编辑配置在claude_desktop_config.json里贴入{ mcpServers: { blender: { command: uvx, args: [mcp-for-blender] } } }注意包名已改为mcp-for-blender旧的uvx blender-mcp也能跑新装请用新名。Cursor、Codex 同理本质都是一条uvx命令拉起服务。⚠️ 改完配置必须彻底退出客户端再重开——它只在启动那一刻读一次这个文件并且同一时间只保留一个客户端挂这个服务两个客户端共用一条 socket 会让响应错乱。确认重启后工具列表里出现blender条目。第 3 步装插件进 Blender 并点 Connect目标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。⚠️ 装完后如果侧边栏没标签页多半是插件没启用——回编辑 偏好设置 插件搜 MCP for Blender 勾上或重启 Blender。确认3D 视口按N键侧边栏出现MCP for Blender标签页里面有资源库勾选框、Port输入框默认9876和Connect to MCP server按钮。最后一步按需勾选资源库比如 Poly Haven免密钥Port保持默认9876点Connect to MCP server。面板从 Not connected 变成 Connected on port 9876链路就跑通了。连通之后先做三件事一句话建个场景低多边形地牢验证标准视口里出现火把、石柱、铁门三类物体Outliner 里能逐一点名。⚠️ 第一条指令偶尔没反应直接重发一次插件是首条命令到达时才真正建立 socket 通道第一次超时是已知行为不是故障。确认面板显示 Connected on port 9876发送创建一个低多边形地牢火把、石柱、一扇铁门哪里不对就补一句把火把往左挪一点原理提炼把场景说成名词清单AI 的建模动作最稳定。让 AI 自己截图视口查错验证标准AI 根据视口截图说出场景里有什么并修正你指出的问题。⚠️ 截图会回传到客户端对话里别在含敏感场景的文件里随手跑。场景建好后追加用视口截图确认一下场景状态指着不对的地方说石柱太高了缩到一半再要一张截图核对原理提炼AI 改完会回头看视口建模从盲改变成操作 → 截图 → 修正的闭环。用 Poly Haven 拉素材铺海滩再导出 GLB验证标准世界环境变成 HDRI 光照场景里出现岩石和植被物体最后拿到一个可打开的.glb文件。⚠️ 素材下载走 Blender 主线程UI 会卡住直到下载完成且分辨率每上一档体积大约翻四倍——离镜头远的素材只要求 1k 或 2k别贪 4k。侧边栏勾选Poly Haven免密钥、无账号CC0 素材发送用 Poly Haven 的 HDRI、岩石和植被做个海滩氛围检查世界环境节点和新增物体追加把当前场景导出为 GLB用export_scene拿到文件给下游用原理提炼插件内置了成套资源管道搜索、下载、应用一条龙AI 不用碰任何网页。卡住时去哪个台子先对号入座再动手你看到的现象走哪条链客户端起不来报spawn错误链 1服务起来了连 Blender 一直超时链 2简单指令正常、复杂请求超时或卡住链 3以上都试过了链 4终极三板斧链 1客户端根本起不来报错原文CtrlF 对号入座failed to start: spawn uvx ENOENT终端执行which uvxmacOS/Linux或where uvxWindows→ 预期打印出完整路径把绝对路径填进配置的commandWindows 也可用command: cmd, args: [/c, uvx, mcp-for-blender]→ 预期配置指向绝对路径。图形界面客户端不继承终端 PATH这就是终端里明明能跑却 ENOENT 的原因彻底退出客户端再重启 → 预期工具列表出现blender条目兜底重装 uvuvx --version重新确认。链 2连不上 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 侧边栏确认面板不是 Not connected → 预期能看到 Connected on port …核对插件面板Port与服务端配置 → 预期两边数字一致确认 Blender 是带界面启动的——blender -b后台模式下命令永远执行不了 → 预期指令有回音兜底侧边栏断开再重连端口再核一遍。链 3复杂请求超时或卡住触发条件简单指令正常复杂请求超时或多个命令挤在一条 socket 上串线。把大任务拆成小指令分步发单次上限 180 秒→ 预期每步都有回执检查是否 Cursor 和 Claude 同时挂着这个 MCP 服务 → 预期同一时间只有一个客户端侧边栏断开重连重建连接 → 预期后续命令恢复正常兜底继续简化请求或重启 Blender。链 4终极三板斧重启 Blender 插件侧边栏 Disconnect → Connect to MCP server彻底重启 MCP 客户端Windows 记得从系统托盘退把配置里的blender服务删掉重新添加这一套基本覆盖九成幽灵问题。参数与开关先对号入座你的情况看哪小节什么都不改只要默认行为默认值一览9876端口被占或同时开两个 Blender换端口两端号码必须一致服务端跑在 Docker / 另一台机器跨机器连接uvx起服务报编译错 / Python 冲突钉死 Python 版本不想上报任何统计关掉遥测怕 AI 跑危险 Python开安全模式默认值一览触发条件什么都不改时先知道服务端在做什么。BLENDER_HOST默认localhost服务端只找本机的 BlenderBLENDER_PORT默认9876插件面板Port默认也是9876单次 socket 请求超时上限 180 秒遥测默认只收集一条最小匿名用量记录你的提示词、代码、截图默认不收集除非你明确勾选同意验证面板显示 Connected on port 9876第一条指令有回音。换端口两端号码必须一致触发条件9876被别的程序占了或你同时开两个 Blender 实例。改法客户端配置env里加BLENDER_PORT: 9877或用 CLI 参数args: [mcp-for-blender, --port, 9877]参数优先于环境变量同时把插件面板Port改成同一个号。验证两边都重连面板显示 Connected on port 9877指令有回音。⚠️ 只改一边等于往一个已注销的号码拨号永远没人接。跨机器连接触发条件MCP 服务端跑在 Docker 里或另一台机器上Blender 本体仍在本机。改法仓库自带Dockerfile镜像默认BLENDER_HOSThost.docker.internalmacOS/Windows 的 Docker Desktop 开箱可达宿主机的 BlenderLinux 上该域名不存在改用 host 网络{ command: docker, args: [run, -i, --rm, --networkhost, -e, BLENDER_HOSTlocalhost, mcp-for-blender] }验证视口截图能正常返回——截图走 base64 回传不依赖共享目录远程也能用。⚠️ 插件的 socket 没有认证和加密任何够得到这个端口的人都能在你的 Blender 里跑 Python跨机器请保持 localhost SSH 隧道别把端口直接暴露到网络。钉死 Python 版本触发条件机器上有 conda / pyenv或新 CPython 没有现成 wheeluvx拉起服务时各种编译报错。改法{ command: uvx, args: [--python, 3.11, mcp-for-blender], env: { UV_PYTHON_PREFERENCE: only-managed } }仍怀疑旧缓存捣乱就清掉重拉uv cache clean mcp-for-blender blender-mcp uvx --refresh mcp-for-blender。验证客户端不再刷编译错误工具列表里blender条目正常出现。关掉遥测触发条件你连最小匿名用量记录都不想发。改法终端export DISABLE_TELEMETRYtrue后再启动或写进客户端配置的envDISABLE_TELEMETRY: true。验证服务端不再有任何上报功能不受影响。开安全模式触发条件默认情况下 AI 能跑任意 Python你想要一道拦截。改法在客户端配置的env或容器args里加BLENDER_MCP_SAFE_MODE: 1服务端会在脚本进 Blender 前做校验拦截直接读写文件、起子进程、碰网络这类危险代码被拦的脚本会连原因一起退回给 AI它换个写法重试。验证让 AI 执行一段含文件读写的脚本预期收到拦截说明而不是执行结果正常建模、材质、渲染不受影响。再往深走一点三个可以继续挖的源码入口src/blender_mcp/server.pyBlenderConnection类锁加 socket 流保证命令不乱序180 秒超时也在这里addon.py侧边栏面板、端口逻辑和命令分发按type路由全在这个文件里README.mdEnvironment Variables 与 Troubleshooting 两节官方排错的最终依据今天 10 分钟就能勾完这几件事☐ 终端验证uvx --version有版本号输出☐ 写好客户端 MCP 配置并彻底重启确认工具列表出现blender条目☐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），仅供参考 MCP for Blender 完整安装教程：从零配置到 10 分钟让 AI 在 Blender 里建出场景
MCP for Blender 完整安装教程从零配置到 10 分钟让 AI 在 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你在 AI 客户端的对话框里敲下建一个低多边形小屋转了十几秒回你一句failed to start: spawn uvx ENOENT换个客户端再试Blender 侧边栏的状态行还卡在 Not connected 一动不动。问题几乎都不在你而是链路里某一环没对上。MCP for Blender 是一个开源插件它让任意大模型Claude、Cursor 里的模型都行通过自然语言直接操作 Blender——建物体、改材质、跑 Python、拉素材。读完这篇你会装通整条链路并且让第一条指令真正在视口里造出东西。30 秒看懂这条链路先看清三根线再动手[AI 客户端 Claude/Cursor/Codex] ⇅ stdioMCP 协议 [MCP 服务端 mcp-for-blender由 uvx 拉起] ⇅ TCP 端口 9876JSON over socket [Blender 插件 addon.pysocket 服务器] ↓ bpy 真正执行建模动作组件你可以把它理解成一句话职责AI 客户端下单的人你说话的地方MCP 服务端前台调度把自然语言拆成 JSON 指令转给 Blender端口9876门牌号两端号码一致才找得到人Blender 插件待命的接线员在 Blender 内部真正执行动作命令和回执都是 JSON。一条最小请求长这样{ type: create_object, params: { type: CUBE } }插件执行后回{ status: success, result: ... }出错则status为error并带message。这就是你和视口之间所有东西的载体。从零到连通第 1 步装 uv拿到 uvx 启动器目标系统里有一个能随时拉起服务端的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打印出版本号才算过关。第 2 步把客户端配置指到服务上目标客户端一启动就自动拉起 MCP 服务端。以 Claude 桌面版为例设置 开发者 编辑配置在claude_desktop_config.json里贴入{ mcpServers: { blender: { command: uvx, args: [mcp-for-blender] } } }注意包名已改为mcp-for-blender旧的uvx blender-mcp也能跑新装请用新名。Cursor、Codex 同理本质都是一条uvx命令拉起服务。⚠️ 改完配置必须彻底退出客户端再重开——它只在启动那一刻读一次这个文件并且同一时间只保留一个客户端挂这个服务两个客户端共用一条 socket 会让响应错乱。确认重启后工具列表里出现blender条目。第 3 步装插件进 Blender 并点 Connect目标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。⚠️ 装完后如果侧边栏没标签页多半是插件没启用——回编辑 偏好设置 插件搜 MCP for Blender 勾上或重启 Blender。确认3D 视口按N键侧边栏出现MCP for Blender标签页里面有资源库勾选框、Port输入框默认9876和Connect to MCP server按钮。最后一步按需勾选资源库比如 Poly Haven免密钥Port保持默认9876点Connect to MCP server。面板从 Not connected 变成 Connected on port 9876链路就跑通了。连通之后先做三件事一句话建个场景低多边形地牢验证标准视口里出现火把、石柱、铁门三类物体Outliner 里能逐一点名。⚠️ 第一条指令偶尔没反应直接重发一次插件是首条命令到达时才真正建立 socket 通道第一次超时是已知行为不是故障。确认面板显示 Connected on port 9876发送创建一个低多边形地牢火把、石柱、一扇铁门哪里不对就补一句把火把往左挪一点原理提炼把场景说成名词清单AI 的建模动作最稳定。让 AI 自己截图视口查错验证标准AI 根据视口截图说出场景里有什么并修正你指出的问题。⚠️ 截图会回传到客户端对话里别在含敏感场景的文件里随手跑。场景建好后追加用视口截图确认一下场景状态指着不对的地方说石柱太高了缩到一半再要一张截图核对原理提炼AI 改完会回头看视口建模从盲改变成操作 → 截图 → 修正的闭环。用 Poly Haven 拉素材铺海滩再导出 GLB验证标准世界环境变成 HDRI 光照场景里出现岩石和植被物体最后拿到一个可打开的.glb文件。⚠️ 素材下载走 Blender 主线程UI 会卡住直到下载完成且分辨率每上一档体积大约翻四倍——离镜头远的素材只要求 1k 或 2k别贪 4k。侧边栏勾选Poly Haven免密钥、无账号CC0 素材发送用 Poly Haven 的 HDRI、岩石和植被做个海滩氛围检查世界环境节点和新增物体追加把当前场景导出为 GLB用export_scene拿到文件给下游用原理提炼插件内置了成套资源管道搜索、下载、应用一条龙AI 不用碰任何网页。卡住时去哪个台子先对号入座再动手你看到的现象走哪条链客户端起不来报spawn错误链 1服务起来了连 Blender 一直超时链 2简单指令正常、复杂请求超时或卡住链 3以上都试过了链 4终极三板斧链 1客户端根本起不来报错原文CtrlF 对号入座failed to start: spawn uvx ENOENT终端执行which uvxmacOS/Linux或where uvxWindows→ 预期打印出完整路径把绝对路径填进配置的commandWindows 也可用command: cmd, args: [/c, uvx, mcp-for-blender]→ 预期配置指向绝对路径。图形界面客户端不继承终端 PATH这就是终端里明明能跑却 ENOENT 的原因彻底退出客户端再重启 → 预期工具列表出现blender条目兜底重装 uvuvx --version重新确认。链 2连不上 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 侧边栏确认面板不是 Not connected → 预期能看到 Connected on port …核对插件面板Port与服务端配置 → 预期两边数字一致确认 Blender 是带界面启动的——blender -b后台模式下命令永远执行不了 → 预期指令有回音兜底侧边栏断开再重连端口再核一遍。链 3复杂请求超时或卡住触发条件简单指令正常复杂请求超时或多个命令挤在一条 socket 上串线。把大任务拆成小指令分步发单次上限 180 秒→ 预期每步都有回执检查是否 Cursor 和 Claude 同时挂着这个 MCP 服务 → 预期同一时间只有一个客户端侧边栏断开重连重建连接 → 预期后续命令恢复正常兜底继续简化请求或重启 Blender。链 4终极三板斧重启 Blender 插件侧边栏 Disconnect → Connect to MCP server彻底重启 MCP 客户端Windows 记得从系统托盘退把配置里的blender服务删掉重新添加这一套基本覆盖九成幽灵问题。参数与开关先对号入座你的情况看哪小节什么都不改只要默认行为默认值一览9876端口被占或同时开两个 Blender换端口两端号码必须一致服务端跑在 Docker / 另一台机器跨机器连接uvx起服务报编译错 / Python 冲突钉死 Python 版本不想上报任何统计关掉遥测怕 AI 跑危险 Python开安全模式默认值一览触发条件什么都不改时先知道服务端在做什么。BLENDER_HOST默认localhost服务端只找本机的 BlenderBLENDER_PORT默认9876插件面板Port默认也是9876单次 socket 请求超时上限 180 秒遥测默认只收集一条最小匿名用量记录你的提示词、代码、截图默认不收集除非你明确勾选同意验证面板显示 Connected on port 9876第一条指令有回音。换端口两端号码必须一致触发条件9876被别的程序占了或你同时开两个 Blender 实例。改法客户端配置env里加BLENDER_PORT: 9877或用 CLI 参数args: [mcp-for-blender, --port, 9877]参数优先于环境变量同时把插件面板Port改成同一个号。验证两边都重连面板显示 Connected on port 9877指令有回音。⚠️ 只改一边等于往一个已注销的号码拨号永远没人接。跨机器连接触发条件MCP 服务端跑在 Docker 里或另一台机器上Blender 本体仍在本机。改法仓库自带Dockerfile镜像默认BLENDER_HOSThost.docker.internalmacOS/Windows 的 Docker Desktop 开箱可达宿主机的 BlenderLinux 上该域名不存在改用 host 网络{ command: docker, args: [run, -i, --rm, --networkhost, -e, BLENDER_HOSTlocalhost, mcp-for-blender] }验证视口截图能正常返回——截图走 base64 回传不依赖共享目录远程也能用。⚠️ 插件的 socket 没有认证和加密任何够得到这个端口的人都能在你的 Blender 里跑 Python跨机器请保持 localhost SSH 隧道别把端口直接暴露到网络。钉死 Python 版本触发条件机器上有 conda / pyenv或新 CPython 没有现成 wheeluvx拉起服务时各种编译报错。改法{ command: uvx, args: [--python, 3.11, mcp-for-blender], env: { UV_PYTHON_PREFERENCE: only-managed } }仍怀疑旧缓存捣乱就清掉重拉uv cache clean mcp-for-blender blender-mcp uvx --refresh mcp-for-blender。验证客户端不再刷编译错误工具列表里blender条目正常出现。关掉遥测触发条件你连最小匿名用量记录都不想发。改法终端export DISABLE_TELEMETRYtrue后再启动或写进客户端配置的envDISABLE_TELEMETRY: true。验证服务端不再有任何上报功能不受影响。开安全模式触发条件默认情况下 AI 能跑任意 Python你想要一道拦截。改法在客户端配置的env或容器args里加BLENDER_MCP_SAFE_MODE: 1服务端会在脚本进 Blender 前做校验拦截直接读写文件、起子进程、碰网络这类危险代码被拦的脚本会连原因一起退回给 AI它换个写法重试。验证让 AI 执行一段含文件读写的脚本预期收到拦截说明而不是执行结果正常建模、材质、渲染不受影响。再往深走一点三个可以继续挖的源码入口src/blender_mcp/server.pyBlenderConnection类锁加 socket 流保证命令不乱序180 秒超时也在这里addon.py侧边栏面板、端口逻辑和命令分发按type路由全在这个文件里README.mdEnvironment Variables 与 Troubleshooting 两节官方排错的最终依据今天 10 分钟就能勾完这几件事☐ 终端验证uvx --version有版本号输出☐ 写好客户端 MCP 配置并彻底重启确认工具列表出现blender条目☐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），仅供参考