BlenderMCP 实战教程让 AI 接管 Blender 建模的完整步骤与连接失败避坑指南【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcpBlenderMCP 是一个让任意大模型直接操控 Blender 3D 的开源桥梁你说一句建个低多边形地牢中间放一条龙它就在 Blender 里真的建出来——建模、改材质、布光、视口截图全部靠对话完成。这篇文章先把它拆成三块讲清楚各自职责再给你每一步能直接抄的配置最后按先定位、再动手的思路整理一份断连救援表全程不留暗坑。BlenderMCP 的完整链路三个部件各自在干什么整条链路长这样AI 客户端Claude / Cursor← MCP 协议 → blender-mcp 服务端 ← TCP:9876 → Blender 插件addon.pyAI 客户端你输入自然语言的地方。它自己不碰 Blender只负责把话转给服务端。blender-mcp 服务端用uvx blender-mcp拉起的翻译官把 AI 的意图翻译成发给 Blender 的 JSON 指令再把结果传回来。注意它不需要你手动挂着——客户端启动时会自动拉起它这是很多人多此一举手动常驻、反而觉得它卡死的根源。Blender 插件addon.py住在 Blender 内部的手负责真正建物体、改节点、截视口图。三块之间靠一根 TCP 连接默认端口 9876。这里有个必须刻进肌肉记忆的要点端口是两侧各填一次的——服务端读环境变量BLENDER_PORT插件端读侧边栏里的 Port 输入框。两边数字不一致表现就是标准的连接超时。如何把两端接起来四步装通 BlenderMCP第一步装好 uvx 这个启动开关服务端靠uvx一条命令下载并运行。三个平台各选一条# macOS brew install uv# Linux curl -LsSf https://astral.sh/uv/install.sh | sh# WindowsPowerShell powershell -c irm https://astral.sh/uv/install.ps1 | iexWindows 装完需把%USERPROFILE%\.local\bin加入 PATH 并重启终端。⚠️ 别用pip install uv凑合它往往不会生成uvx命令后面所有配置都会卡在第一步。第二步告诉 AI 客户端服务端在哪以 Claude 桌面版为例路径是设置 开发者 编辑配置claude_desktop_config.json贴上{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }改完必须完全退出客户端再重开热切换读不到新配置。两个高频变体Windows 上的 Cursor / 任何 GUI 客户端图形界面程序启动时看不到你在终端里配的 PATH直接写command: uvx会报spawn uvx ENOENT。改走cmd转发{ mcpServers: { blender: { command: cmd, args: [/c, uvx, blender-mcp] } } }机器上有 conda / pyenv 导致 Python 打架给服务端钉死解释器版本{ mcpServers: { blender: { command: uvx, args: [--python, 3.11, blender-mcp], env: { UV_PYTHON_PREFERENCE: only-managed } } } }第三步把插件装进 Blender 并点 Connect拿到仓库根目录的 addon.py——整个插件就这一个文件Blender 里编辑 偏好设置 插件 安装...选中它勾选启用Interface: Blender MCP在 3D 视图按N唤出侧边栏切到BlenderMCP标签确认端口填的是 9876点Connect to Claude面板显示运行中即插件端就绪第四步发出第一句话确认链路通了回客户端发一条创建一个低多边形地牢有火把、石柱和一扇铁门。对话区出现锤子图标、Blender 视口开始自己动说明全链路打通。 第一条指令偶尔石沉大海是首连 socket 的常见现象原样重发一次通常就好了。如何配对环境变量BLENDER_HOST、BLENDER_PORT 与遥测开关环境变量是服务端的出厂设定进程启动时读一次决定它往哪台机器、哪个端口拨号变量默认值作用什么时候改BLENDER_HOSTlocalhost服务端连接 Blender 用的主机地址Docker / WSL / 远程部署BLENDER_PORT9876服务端连接用的端口端口被占时改 9877 之类BLENDER_MCP_DISABLE_TELEMETRY未设置关闭匿名使用统计设成true全关插件侧边栏 Port9876Blender 端监听端口必须与BLENDER_PORT逐位一致容器、WSL、远程部署下怎么配关键原则只有一条Blender 得监听在 MCP 进程够得着的位置。在客户端配置里加envenv: { BLENDER_HOST: host.docker.internal, BLENDER_PORT: 9876 }WSL2 连 Windows 侧的 Blender 时优先试BLENDER_HOST127.0.0.1不通再换 Windows 主机 IP。视口截图是以 base64 编码回传的不依赖双方共享临时目录所以远程场景下让 AI 看图自查依然可用。命令行如何直接启动 blender-mcp 服务不走配置文件的话Claude Code CLI 一行注册claude mcp add blender uvx blender-mcp也可以手动打好环境变量再启动调试时用export BLENDER_HOSTlocalhost export BLENDER_PORT9876 export BLENDER_MCP_DISABLE_TELEMETRYtrue uvx blender-mcp三个实操细节别把uvx blender-mcp当常驻进程手动跑。它静默等待客户端连接时看起来像挂住按Ctrl-C即可退出。嫌版本不更新uv cache clean blender-mcp uvx --refresh blender-mcp清缓存再刷新。完全不想用 uv 的话pipx install blender-mcp是等价替代。接上之后能干什么四类常见诉求的玩法一句话建场景并让 AI 自己截图核对这是最推荐的闭环先下指令低多边形地牢火把、石柱、铁门等模型出来后追一句用截图确认一下场景状态。这会触发视口截图工具AI 能亲眼看到建出来的东西你再一句把火把往左挪一点它就是基于截图和场景信息做修正而不是盲改。如何精确控制材质与光照AI 可以通过execute_blender_code在 Blender 内执行任意 Python这是材质控制最细的路径——比如把这个立方体变成金色金属它会直接操作节点树新建 Principled BSDF、调 Base Color / Metallic / Roughness、赋给对象。⚠️ 这条工具等于把 Blender 的控制权整个交给 AI动手前先保存文件是铁律。外部资源怎么调Poly Haven、Sketchfab 与生成式模型在侧边栏 BlenderMCP 面板勾选对应功能、对话中直接指挥即可Poly Haven让 AI用 Poly Haven 的 HDRI、岩石和植被做海滩氛围它自动搜索并下载HDRI 会直接设为世界环境。Sketchfab在插件偏好里填好 API Key 后可以搜一把中世纪椅子并导入支持缩略图预览、确认后下载、按目标尺寸归一化。Hyper3D Rodin / Hunyuan3D描述需求生成自带材质的定制模型再导入场景。选型口诀现成具体物件先查 Sketchfab通用家具和氛围光走 Poly Haven库里都没有的定制需求才用生成式。连接失败救援表先看信号再动手修按症状 → 卡在哪 → 怎么修排好序遇到对号入座症状卡在哪个部件修法报spawn uvx ENOENT客户端起不来GUI 客户端看不到终端 PATH用which uvxmacOS/Linux或where uvxWindows取全路径填进commandWindows 直接走cmd /c uvx blender-mcp写法服务端起来了但连接超时插件没在监听或两侧端口/主机对不上①侧边栏确认显示运行中②BLENDER_PORT与插件 Port 逐位核对③防火墙放行 9876④Blender 必须带界面启动——blender -b后台模式下命令永远不会执行服务端报错里也会直接提示这一点指令发出后卡很久、超时、流式响应错乱单次任务超过 socket 的 180 秒超时或两个客户端抢同一条连接把大任务拆成几步小指令逐步喂同一时间只保留一个 MCP 客户端Cursor 和 Claude 别同时挂uvx 反复编译报错Python 版本冲突Apple Silicon 上可能去编 x86_64 的包配置里args: [--python, 3.11, blender-mcp]加env: { UV_PYTHON_PREFERENCE: only-managed }Apple Silicon 可试3.11-aarch64以上都试过仍不通陈旧状态残留三板斧重启 Blender 插件 → 重启 MCP 客户端 → 把配置里 blender 服务删掉重新添加源码入口在哪里如何升级想看命令为什么不会乱序src/blender_mcp/server.py 里的BlenderConnection一把锁把发送接收串起来保证第二条指令的响应不会被误读成第一条的。想看插件端面板注册与端口逻辑addon.py。升级流程两步下载最新版addon.py替换旧文件在客户端配置里删掉 blender 服务再重新添加一次。记住这条主线就够用了客户端管说话uvx blender-mcp管翻译addon.py管动手9876 两边必须一致——链路里任何一块错位表现都逃不出上面那张救援表。【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 BlenderMCP 实战教程：让 AI 接管 Blender 建模的完整步骤与连接失败避坑指南
BlenderMCP 实战教程让 AI 接管 Blender 建模的完整步骤与连接失败避坑指南【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcpBlenderMCP 是一个让任意大模型直接操控 Blender 3D 的开源桥梁你说一句建个低多边形地牢中间放一条龙它就在 Blender 里真的建出来——建模、改材质、布光、视口截图全部靠对话完成。这篇文章先把它拆成三块讲清楚各自职责再给你每一步能直接抄的配置最后按先定位、再动手的思路整理一份断连救援表全程不留暗坑。BlenderMCP 的完整链路三个部件各自在干什么整条链路长这样AI 客户端Claude / Cursor← MCP 协议 → blender-mcp 服务端 ← TCP:9876 → Blender 插件addon.pyAI 客户端你输入自然语言的地方。它自己不碰 Blender只负责把话转给服务端。blender-mcp 服务端用uvx blender-mcp拉起的翻译官把 AI 的意图翻译成发给 Blender 的 JSON 指令再把结果传回来。注意它不需要你手动挂着——客户端启动时会自动拉起它这是很多人多此一举手动常驻、反而觉得它卡死的根源。Blender 插件addon.py住在 Blender 内部的手负责真正建物体、改节点、截视口图。三块之间靠一根 TCP 连接默认端口 9876。这里有个必须刻进肌肉记忆的要点端口是两侧各填一次的——服务端读环境变量BLENDER_PORT插件端读侧边栏里的 Port 输入框。两边数字不一致表现就是标准的连接超时。如何把两端接起来四步装通 BlenderMCP第一步装好 uvx 这个启动开关服务端靠uvx一条命令下载并运行。三个平台各选一条# macOS brew install uv# Linux curl -LsSf https://astral.sh/uv/install.sh | sh# WindowsPowerShell powershell -c irm https://astral.sh/uv/install.ps1 | iexWindows 装完需把%USERPROFILE%\.local\bin加入 PATH 并重启终端。⚠️ 别用pip install uv凑合它往往不会生成uvx命令后面所有配置都会卡在第一步。第二步告诉 AI 客户端服务端在哪以 Claude 桌面版为例路径是设置 开发者 编辑配置claude_desktop_config.json贴上{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }改完必须完全退出客户端再重开热切换读不到新配置。两个高频变体Windows 上的 Cursor / 任何 GUI 客户端图形界面程序启动时看不到你在终端里配的 PATH直接写command: uvx会报spawn uvx ENOENT。改走cmd转发{ mcpServers: { blender: { command: cmd, args: [/c, uvx, blender-mcp] } } }机器上有 conda / pyenv 导致 Python 打架给服务端钉死解释器版本{ mcpServers: { blender: { command: uvx, args: [--python, 3.11, blender-mcp], env: { UV_PYTHON_PREFERENCE: only-managed } } } }第三步把插件装进 Blender 并点 Connect拿到仓库根目录的 addon.py——整个插件就这一个文件Blender 里编辑 偏好设置 插件 安装...选中它勾选启用Interface: Blender MCP在 3D 视图按N唤出侧边栏切到BlenderMCP标签确认端口填的是 9876点Connect to Claude面板显示运行中即插件端就绪第四步发出第一句话确认链路通了回客户端发一条创建一个低多边形地牢有火把、石柱和一扇铁门。对话区出现锤子图标、Blender 视口开始自己动说明全链路打通。 第一条指令偶尔石沉大海是首连 socket 的常见现象原样重发一次通常就好了。如何配对环境变量BLENDER_HOST、BLENDER_PORT 与遥测开关环境变量是服务端的出厂设定进程启动时读一次决定它往哪台机器、哪个端口拨号变量默认值作用什么时候改BLENDER_HOSTlocalhost服务端连接 Blender 用的主机地址Docker / WSL / 远程部署BLENDER_PORT9876服务端连接用的端口端口被占时改 9877 之类BLENDER_MCP_DISABLE_TELEMETRY未设置关闭匿名使用统计设成true全关插件侧边栏 Port9876Blender 端监听端口必须与BLENDER_PORT逐位一致容器、WSL、远程部署下怎么配关键原则只有一条Blender 得监听在 MCP 进程够得着的位置。在客户端配置里加envenv: { BLENDER_HOST: host.docker.internal, BLENDER_PORT: 9876 }WSL2 连 Windows 侧的 Blender 时优先试BLENDER_HOST127.0.0.1不通再换 Windows 主机 IP。视口截图是以 base64 编码回传的不依赖双方共享临时目录所以远程场景下让 AI 看图自查依然可用。命令行如何直接启动 blender-mcp 服务不走配置文件的话Claude Code CLI 一行注册claude mcp add blender uvx blender-mcp也可以手动打好环境变量再启动调试时用export BLENDER_HOSTlocalhost export BLENDER_PORT9876 export BLENDER_MCP_DISABLE_TELEMETRYtrue uvx blender-mcp三个实操细节别把uvx blender-mcp当常驻进程手动跑。它静默等待客户端连接时看起来像挂住按Ctrl-C即可退出。嫌版本不更新uv cache clean blender-mcp uvx --refresh blender-mcp清缓存再刷新。完全不想用 uv 的话pipx install blender-mcp是等价替代。接上之后能干什么四类常见诉求的玩法一句话建场景并让 AI 自己截图核对这是最推荐的闭环先下指令低多边形地牢火把、石柱、铁门等模型出来后追一句用截图确认一下场景状态。这会触发视口截图工具AI 能亲眼看到建出来的东西你再一句把火把往左挪一点它就是基于截图和场景信息做修正而不是盲改。如何精确控制材质与光照AI 可以通过execute_blender_code在 Blender 内执行任意 Python这是材质控制最细的路径——比如把这个立方体变成金色金属它会直接操作节点树新建 Principled BSDF、调 Base Color / Metallic / Roughness、赋给对象。⚠️ 这条工具等于把 Blender 的控制权整个交给 AI动手前先保存文件是铁律。外部资源怎么调Poly Haven、Sketchfab 与生成式模型在侧边栏 BlenderMCP 面板勾选对应功能、对话中直接指挥即可Poly Haven让 AI用 Poly Haven 的 HDRI、岩石和植被做海滩氛围它自动搜索并下载HDRI 会直接设为世界环境。Sketchfab在插件偏好里填好 API Key 后可以搜一把中世纪椅子并导入支持缩略图预览、确认后下载、按目标尺寸归一化。Hyper3D Rodin / Hunyuan3D描述需求生成自带材质的定制模型再导入场景。选型口诀现成具体物件先查 Sketchfab通用家具和氛围光走 Poly Haven库里都没有的定制需求才用生成式。连接失败救援表先看信号再动手修按症状 → 卡在哪 → 怎么修排好序遇到对号入座症状卡在哪个部件修法报spawn uvx ENOENT客户端起不来GUI 客户端看不到终端 PATH用which uvxmacOS/Linux或where uvxWindows取全路径填进commandWindows 直接走cmd /c uvx blender-mcp写法服务端起来了但连接超时插件没在监听或两侧端口/主机对不上①侧边栏确认显示运行中②BLENDER_PORT与插件 Port 逐位核对③防火墙放行 9876④Blender 必须带界面启动——blender -b后台模式下命令永远不会执行服务端报错里也会直接提示这一点指令发出后卡很久、超时、流式响应错乱单次任务超过 socket 的 180 秒超时或两个客户端抢同一条连接把大任务拆成几步小指令逐步喂同一时间只保留一个 MCP 客户端Cursor 和 Claude 别同时挂uvx 反复编译报错Python 版本冲突Apple Silicon 上可能去编 x86_64 的包配置里args: [--python, 3.11, blender-mcp]加env: { UV_PYTHON_PREFERENCE: only-managed }Apple Silicon 可试3.11-aarch64以上都试过仍不通陈旧状态残留三板斧重启 Blender 插件 → 重启 MCP 客户端 → 把配置里 blender 服务删掉重新添加源码入口在哪里如何升级想看命令为什么不会乱序src/blender_mcp/server.py 里的BlenderConnection一把锁把发送接收串起来保证第二条指令的响应不会被误读成第一条的。想看插件端面板注册与端口逻辑addon.py。升级流程两步下载最新版addon.py替换旧文件在客户端配置里删掉 blender 服务再重新添加一次。记住这条主线就够用了客户端管说话uvx blender-mcp管翻译addon.py管动手9876 两边必须一致——链路里任何一块错位表现都逃不出上面那张救援表。【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考