BlenderMCP 实战指南把 AI 接进 Blender 的完整配置流程【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp刚装好 Blender想让 Claude 帮你建场景结果消息发出去半天没动静——要么连接超时要么 AI 假装没听见。BlenderMCP 是一个开源 Blender AI 插件它靠 MCP 这条标准通道把 Blender 和 Claude、Cursor 这些 AI 客户端接起来你用自然语言说话它负责建物体、改材质、截视口图。不想手动点几百次菜单的人往下看。动手之前先看懂它是怎么连上的AI 客户端、MCP 服务端、Blender 插件各管什么整套系统是三个人接力干一件活AI 客户端Claude 桌面版、Cursor你聊天的窗口负责把指令派出去。MCP 服务端blender-mcp这个 Python 程序翻译官兼调度员把 AI 的话转成 Blender 听得懂的命令。MCPModel Context Protocol就是一个标准接口AI 工具和软件之间的普通话两边都懂它就不用各自开发适配。Blender 插件一个addon.py文件真正动手的师傅建物体、调材质、截视口图全在 Blender 进程里完成。缺了任何一个链路就断在中间AI 说得出话Blender 却一动不动。9876 端口和两处端口设置为什么必须对得上端口你可以理解成餐厅的取餐号Blender 插件在 9876 号窗口开着等活干MCP 服务端拿着同样的 9876 号窗口去敲号不对就永远等不到菜。关键坑在于这个号在两个地方各写了一遍——MCP 服务端那边是环境变量BLENDER_PORT没设就是 9876Blender 侧边栏面板里也有一个端口输入框默认同样是 9876。两边必须一致否则就是一方在 9876 等、另一方往 9877 送怎么等都等不来。从零跑通完整配置流程下面按检查点推进每过一个点再继续下一个。检查点一uv 一次性装好服务端用 Python 写uv是它的启动器加包管理器uvx命令就装在它里面。按系统挑一条# macOS brew install uv # Linux curl -LsSf https://astral.sh/uv/install.sh | sh# Windows powershell -c irm https://astral.sh/uv/install.ps1 | iexWindows 装完把%USERPROFILE%\.local\bin加进 PATH然后重开终端。验证方式uvx --version有版本号输出来就算过点。⚠️ 别用pip install uv凑数——它经常不生成uvx命令后患无穷。检查点二让 AI 客户端拉起服务以 Claude 桌面版为例设置 → 开发者 → 编辑配置把下面这段贴进claude_desktop_config.json{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }这段告诉 Claude启动时用它来找blender-mcp这个服务进程。改完配置要把客户端完全退出再重开热重载不认。Cursor 在 macOS / Linux 上写法和上面完全一样Windows 上的写法不一样放到下一节单独讲。检查点三把 addon.py 装进 Blender 并启用整个 Blender 侧插件就是仓库里的addon.py一个文件addon.py。Blender 里进Edit → Preferences → Add-ons点Install...选中addon.py列表里勾选Interface: Blender MCP启用装完 Blender 的 3D 视图侧边栏就会多出 BlenderMCP 面板后面所有连接操作都在那。检查点四连接并发出第一句指令3D 视图按N唤出侧边栏切到BlenderMCP标签点Connect to Claude面板显示Running on port 9876这类字样说明插件端窗口已开检查点四过回 Claude 发一句创建一个低多边形地牢场景里面有火把、石柱和一扇铁门。AI 回复里出现锤子图标表示 Blender 工具已激活。 第一条指令偶尔没反应是常态——首次建 socket 连接的常见现象原句再发一遍就好。检查点五用截图让 AI 自查建完别急着关窗口追一句截个视口图确认一下场景状态。视口截图工具会把画面以 base64 形式回传给 AI——AI 等于睁开了眼能发现自己把火把建到了墙里。然后闭环就转起来了操作 → 截图验证 → 修正。哪里不对就直接说火把往左挪一点AI 会基于截图和场景信息改而不是盲改。这个习惯建议从第一天就养成。按你的环境改配置所有可动的旋钮一张表放齐都是环境变量或面板字段配置项默认值什么时候改BLENDER_HOSTlocalhostBlender 不在本机Docker / WSL / 远程主机BLENDER_PORT9876端口被占比如改成9877BLENDER_MCP_DISABLE_TELEMETRY未设置匿名统计默认开想彻底关掉匿名使用统计设true插件侧边栏 Port 字段9876只要改过BLENDER_PORT这里同步改Windows 上的 CursorWindows 的图形界面程序不继承你终端的 PATH——终端里找得到的命令GUI 程序直接看不见。所以 Cursor 得先调起cmd再执行uvx{ mcpServers: { blender: { command: cmd, args: [/c, uvx, blender-mcp] } } }cmd /c的作用就是先开一个命令行窗口再在里面跑后面的命令PATH 自然就带上了。macOS / Linux 的 Cursor 继续用上面uvx原写法不用动。Docker / WSL / 远程主机原则只有一条Blender 要监听在 MCP 进程够得着的地方也就是改BLENDER_HOST的取值Blender 在 Docker 容器里、服务端在宿主机BLENDER_HOSThost.docker.internalWSL2 里连 Windows 上的 Blender先试127.0.0.1不行再换成 Windows 主机 IP截图以 base64 直接返回不依赖共享临时目录远程场景照样能用env: { BLENDER_HOST: host.docker.internal, BLENDER_PORT: 9876 }Python 版本打架时钉死版本机器上同时有 conda、pyenvuvx 就可能挑错解释器。把服务端钉在一个干净的 Python 上args: [--python, 3.11, blender-mcp], env: { UV_PYTHON_PREFERENCE: only-managed }only-managed的意思是只用 uv 自己管理的 Python别碰我系统里那些。Apple Silicon 上如果还报 x86_64 编译错把版本换成3.11-aarch64。命令行直接跑不走配置文件的话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退出即可。连上之后这几个玩法值得试视口截图闭环前面检查点五说过的那套操作 → 截图 → 修正。让 AI 的每一步都看得见是稳定出图的核心。任意 Python 执行execute_blender_code工具能在 Blender 里跑任意 Python材质控制到最细都走这条路。比如把立方体变成金色金属AI 背后干的事就是建一个节点材质、设 Base Color / Metallic / Roughness、再赋给对象mat bpy.data.materials.new(GoldMaterial) mat.use_nodes True mat.node_tree.nodes[Principled BSDF].inputs[Base Color].default_value (0.9, 0.7, 0.1, 1) mat.node_tree.nodes[Principled BSDF].inputs[Metallic].default_value 1.0⚠️它等于把 Blender 的控制权整个交给了 AI用之前先把文件保存好这是铁律。Poly Haven 管道侧边栏勾选启用后让 AI用 Poly Haven 的 HDRI、岩石和植被做个海滩氛围它会自己搜索下载贴图、HDRI 和模型HDR 直接设为世界环境。Sketchfab 管道插件偏好里填好 API Key 后让 AI在 Sketchfab 上搜一把中世纪椅子并导入。支持先取缩略图预览、你确认后再下载还能按目标尺寸归一化——椅子 1 米、桌子 0.75 米。生成式建模Hyper3D Rodin / Hunyuan3D前两条管道都找不到想要的东西时再上它描述一下需求AI 生成带材质的模型直接进场景。选型一句话具体现成的物件先搜 Sketchfab通用家具和场景素材走 Poly Haven都找不到才用生成式。报错时按现象对表现象 / 报错原文可能原因一行解法spawn uvx ENOENTGUI 客户端不继承终端 PATH找不到uvxwhich uvx/where uvx拿全路径填进command改完重启客户端连接超时AI 说连不上 Blender插件端窗口没开、两边端口不一致或用了blender -b后台模式侧边栏确认 Running核对BLENDER_PORT与面板端口确认 Blender 是带 GUI 启动的命令卡死、超时或流式响应错乱请求太复杂撞上 180 秒 socket 超时或两个客户端同时挂着服务大任务拆成小指令分步喂同一时间只保留一个客户端Python 编译报错尤其 Apple Silicon 拉 x86_64 包conda / pyenv 的解释器和依赖打架--python 3.11UV_PYTHON_PREFERENCEonly-managed再不行uv cache clean blender-mcp uvx --refresh blender-mcp清缓存刷新另外服务端超时会直接提示Timeout waiting for Blender response并明确说后台模式下命令永远不会执行src/blender_mcp/server.py而连接用的锁与 socket 流逻辑就在同文件的BlenderConnection里端口和面板注册逻辑在 addon.py。升级时把最新addon.py替换进 Blender再把客户端配置里的 blender 服务删掉重加一遍。发车前检查☐uvx --version有版本号输出☐ 客户端配置已写入且客户端是完全退出后重开的☐addon.py已启用侧边栏点 Connect 后显示 Running☐ 第一条指令发出后要求 AI 截图核对☐ 至少试过一次 Poly Haven 或 Sketchfab哪一步卡住了把报错原文、客户端类型、系统版本贴过来按现象对表基本都能定位。【免费下载链接】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 的完整配置流程【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp刚装好 Blender想让 Claude 帮你建场景结果消息发出去半天没动静——要么连接超时要么 AI 假装没听见。BlenderMCP 是一个开源 Blender AI 插件它靠 MCP 这条标准通道把 Blender 和 Claude、Cursor 这些 AI 客户端接起来你用自然语言说话它负责建物体、改材质、截视口图。不想手动点几百次菜单的人往下看。动手之前先看懂它是怎么连上的AI 客户端、MCP 服务端、Blender 插件各管什么整套系统是三个人接力干一件活AI 客户端Claude 桌面版、Cursor你聊天的窗口负责把指令派出去。MCP 服务端blender-mcp这个 Python 程序翻译官兼调度员把 AI 的话转成 Blender 听得懂的命令。MCPModel Context Protocol就是一个标准接口AI 工具和软件之间的普通话两边都懂它就不用各自开发适配。Blender 插件一个addon.py文件真正动手的师傅建物体、调材质、截视口图全在 Blender 进程里完成。缺了任何一个链路就断在中间AI 说得出话Blender 却一动不动。9876 端口和两处端口设置为什么必须对得上端口你可以理解成餐厅的取餐号Blender 插件在 9876 号窗口开着等活干MCP 服务端拿着同样的 9876 号窗口去敲号不对就永远等不到菜。关键坑在于这个号在两个地方各写了一遍——MCP 服务端那边是环境变量BLENDER_PORT没设就是 9876Blender 侧边栏面板里也有一个端口输入框默认同样是 9876。两边必须一致否则就是一方在 9876 等、另一方往 9877 送怎么等都等不来。从零跑通完整配置流程下面按检查点推进每过一个点再继续下一个。检查点一uv 一次性装好服务端用 Python 写uv是它的启动器加包管理器uvx命令就装在它里面。按系统挑一条# macOS brew install uv # Linux curl -LsSf https://astral.sh/uv/install.sh | sh# Windows powershell -c irm https://astral.sh/uv/install.ps1 | iexWindows 装完把%USERPROFILE%\.local\bin加进 PATH然后重开终端。验证方式uvx --version有版本号输出来就算过点。⚠️ 别用pip install uv凑数——它经常不生成uvx命令后患无穷。检查点二让 AI 客户端拉起服务以 Claude 桌面版为例设置 → 开发者 → 编辑配置把下面这段贴进claude_desktop_config.json{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }这段告诉 Claude启动时用它来找blender-mcp这个服务进程。改完配置要把客户端完全退出再重开热重载不认。Cursor 在 macOS / Linux 上写法和上面完全一样Windows 上的写法不一样放到下一节单独讲。检查点三把 addon.py 装进 Blender 并启用整个 Blender 侧插件就是仓库里的addon.py一个文件addon.py。Blender 里进Edit → Preferences → Add-ons点Install...选中addon.py列表里勾选Interface: Blender MCP启用装完 Blender 的 3D 视图侧边栏就会多出 BlenderMCP 面板后面所有连接操作都在那。检查点四连接并发出第一句指令3D 视图按N唤出侧边栏切到BlenderMCP标签点Connect to Claude面板显示Running on port 9876这类字样说明插件端窗口已开检查点四过回 Claude 发一句创建一个低多边形地牢场景里面有火把、石柱和一扇铁门。AI 回复里出现锤子图标表示 Blender 工具已激活。 第一条指令偶尔没反应是常态——首次建 socket 连接的常见现象原句再发一遍就好。检查点五用截图让 AI 自查建完别急着关窗口追一句截个视口图确认一下场景状态。视口截图工具会把画面以 base64 形式回传给 AI——AI 等于睁开了眼能发现自己把火把建到了墙里。然后闭环就转起来了操作 → 截图验证 → 修正。哪里不对就直接说火把往左挪一点AI 会基于截图和场景信息改而不是盲改。这个习惯建议从第一天就养成。按你的环境改配置所有可动的旋钮一张表放齐都是环境变量或面板字段配置项默认值什么时候改BLENDER_HOSTlocalhostBlender 不在本机Docker / WSL / 远程主机BLENDER_PORT9876端口被占比如改成9877BLENDER_MCP_DISABLE_TELEMETRY未设置匿名统计默认开想彻底关掉匿名使用统计设true插件侧边栏 Port 字段9876只要改过BLENDER_PORT这里同步改Windows 上的 CursorWindows 的图形界面程序不继承你终端的 PATH——终端里找得到的命令GUI 程序直接看不见。所以 Cursor 得先调起cmd再执行uvx{ mcpServers: { blender: { command: cmd, args: [/c, uvx, blender-mcp] } } }cmd /c的作用就是先开一个命令行窗口再在里面跑后面的命令PATH 自然就带上了。macOS / Linux 的 Cursor 继续用上面uvx原写法不用动。Docker / WSL / 远程主机原则只有一条Blender 要监听在 MCP 进程够得着的地方也就是改BLENDER_HOST的取值Blender 在 Docker 容器里、服务端在宿主机BLENDER_HOSThost.docker.internalWSL2 里连 Windows 上的 Blender先试127.0.0.1不行再换成 Windows 主机 IP截图以 base64 直接返回不依赖共享临时目录远程场景照样能用env: { BLENDER_HOST: host.docker.internal, BLENDER_PORT: 9876 }Python 版本打架时钉死版本机器上同时有 conda、pyenvuvx 就可能挑错解释器。把服务端钉在一个干净的 Python 上args: [--python, 3.11, blender-mcp], env: { UV_PYTHON_PREFERENCE: only-managed }only-managed的意思是只用 uv 自己管理的 Python别碰我系统里那些。Apple Silicon 上如果还报 x86_64 编译错把版本换成3.11-aarch64。命令行直接跑不走配置文件的话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退出即可。连上之后这几个玩法值得试视口截图闭环前面检查点五说过的那套操作 → 截图 → 修正。让 AI 的每一步都看得见是稳定出图的核心。任意 Python 执行execute_blender_code工具能在 Blender 里跑任意 Python材质控制到最细都走这条路。比如把立方体变成金色金属AI 背后干的事就是建一个节点材质、设 Base Color / Metallic / Roughness、再赋给对象mat bpy.data.materials.new(GoldMaterial) mat.use_nodes True mat.node_tree.nodes[Principled BSDF].inputs[Base Color].default_value (0.9, 0.7, 0.1, 1) mat.node_tree.nodes[Principled BSDF].inputs[Metallic].default_value 1.0⚠️它等于把 Blender 的控制权整个交给了 AI用之前先把文件保存好这是铁律。Poly Haven 管道侧边栏勾选启用后让 AI用 Poly Haven 的 HDRI、岩石和植被做个海滩氛围它会自己搜索下载贴图、HDRI 和模型HDR 直接设为世界环境。Sketchfab 管道插件偏好里填好 API Key 后让 AI在 Sketchfab 上搜一把中世纪椅子并导入。支持先取缩略图预览、你确认后再下载还能按目标尺寸归一化——椅子 1 米、桌子 0.75 米。生成式建模Hyper3D Rodin / Hunyuan3D前两条管道都找不到想要的东西时再上它描述一下需求AI 生成带材质的模型直接进场景。选型一句话具体现成的物件先搜 Sketchfab通用家具和场景素材走 Poly Haven都找不到才用生成式。报错时按现象对表现象 / 报错原文可能原因一行解法spawn uvx ENOENTGUI 客户端不继承终端 PATH找不到uvxwhich uvx/where uvx拿全路径填进command改完重启客户端连接超时AI 说连不上 Blender插件端窗口没开、两边端口不一致或用了blender -b后台模式侧边栏确认 Running核对BLENDER_PORT与面板端口确认 Blender 是带 GUI 启动的命令卡死、超时或流式响应错乱请求太复杂撞上 180 秒 socket 超时或两个客户端同时挂着服务大任务拆成小指令分步喂同一时间只保留一个客户端Python 编译报错尤其 Apple Silicon 拉 x86_64 包conda / pyenv 的解释器和依赖打架--python 3.11UV_PYTHON_PREFERENCEonly-managed再不行uv cache clean blender-mcp uvx --refresh blender-mcp清缓存刷新另外服务端超时会直接提示Timeout waiting for Blender response并明确说后台模式下命令永远不会执行src/blender_mcp/server.py而连接用的锁与 socket 流逻辑就在同文件的BlenderConnection里端口和面板注册逻辑在 addon.py。升级时把最新addon.py替换进 Blender再把客户端配置里的 blender 服务删掉重加一遍。发车前检查☐uvx --version有版本号输出☐ 客户端配置已写入且客户端是完全退出后重开的☐addon.py已启用侧边栏点 Connect 后显示 Running☐ 第一条指令发出后要求 AI 截图核对☐ 至少试过一次 Poly Haven 或 Sketchfab哪一步卡住了把报错原文、客户端类型、系统版本贴过来按现象对表基本都能定位。【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
