BlenderMCP配置从零到通3步连上AI建模助手附8个高频报错自查清单【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcpBlenderMCP是一款通过模型上下文协议MCP把Blender 3D与任意大语言模型连在一起的社区插件装上之后你可以在对话里直接指挥AI帮你建模、打光、调材质。可很多人的第一反应是装好了却怎么都连不上。别急这篇文章就解决连不上这件事——读完你会掌握用 uvx 一条命令拉起MCP服务器、看懂并改对主机地址与端口、在桌面客户端和代码编辑器里各配一份正确配置、以及按图索骥排查八成常见报错。十分钟内跑通安装—配置—连接全流程弄懂BLENDER_HOST/BLENDER_PORT两个核心参数的含义与改法对照样例写出 Claude Desktop 与 Cursor 两份可直接用的配置用一张报错自查清单快速定位连不上的根因跑通一个最小实战案例亲眼看到AI在Blender里动手一、先搞懂它在做什么一个翻译官的故事打个比方Blender是个只会听Python指令的哑巴AI助手只会说自然语言两人天生无法对话。BlenderMCP就是站在中间的翻译官兼传令兵你把帮我建一个球这句话丢给AIMCP服务器把它翻译成Blender能执行的指令通过一条TCP通道默认端口9876送到Blender插件那里插件执行完再把结果传回来。全程走的是客户端 → MCP服务器 → 套接字 → 插件这条链路任何一环断掉表现都是同一个词连不上。这适合谁用如果你是3D新手想用大白话描述场景让AI代劳或是老建模师想提速重复性操作再或是想试试用AI做资产库搜索、材质微调——都值得装上。它的价值不在于替代你建模而在于把脑子里想、嘴上说和Blender里做之间的翻译成本降到几乎为零。二、装好这三样十分钟跑通全流程这一节做完你就能在AI对话框里直接指挥Blender。全程只有三步每步都有可照抄的命令和该看到的预期结果。第1步装 uv 包管理器。BlenderMCP 的服务器本体通过uvx命令启动而uvx来自 uv。macOS 用户执行brew install uvWindows 用户在 PowerShell 里运行# Windows安装 uv 并把它加进用户 PATH装完重启终端 powershell -c irm https://astral.sh/uv/install.ps1 | iex装完敲一句uvx --version能打印出版本号就说明第一步通了。注意别用pip install uv它未必会生成uvx命令后续会白踩一个坑。第2步在Blender里装插件。从项目仓库拿到addon.py可直接git clone https://gitcode.com/GitHub_Trending/bl/blender-mcp获取整个仓库然后打开 Blender进入编辑 偏好设置 插件点安装...选中addon.py最后勾选启用Interface: Blender MCP。启用成功后3D视图右侧会出现一个叫 Blender MCP 的面板——看到它就成功了。第3步把客户端和Blender接上线。先回到Blender按N键呼出侧边栏切到BlenderMCP选项卡点Connect to Claude。再把下面这段JSON写进 Claude 桌面版的配置文件路径在Claude Settings Developer Edit Config的claude_desktop_config.json{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }保存后完全退出并重启 Claude 客户端等它加载完服务器对话框里出现锤子图标就说明这条链路已经通了。连接面板长下图这样图片正中的 BlenderMCP 面板就是你的总开关三、核心参数就两个地址和端口别让它们打架BlenderMCP 的服务器在启动时只认两个环境变量其余全部有默认值绝大多数人根本不用改。先记住这张对照表配置项作用默认值什么时候需要修改BLENDER_HOSTMCP服务器去哪个地址找Blender插件localhostDocker/WSL/远程主机里跑Blender时BLENDER_PORT与插件通信的TCP端口9876端口被占用或你在插件偏好里改了端口时在终端里临时指定它们的写法是# 示例Docker 容器里运行让服务器去宿主机找 Blender export BLENDER_HOSThost.docker.internal export BLENDER_PORT9876接入方式不同配置文件长得也不一样下面给最常见的两种。Claude Desktop通用写法macOS/Linux/Windows 通吃{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }CursorWindows 用户必须套一层cmd /c否则找不到 uvx{ mcpServers: { blender: { command: cmd, args: [/c, uvx, blender-mcp] } } }最容易被坑的一点千万别同时开着 Cursor 和 Claude Desktop 两份 MCP 服务器。两个客户端会同时抢 9876 端口结果就是两边都报连接失败。同一时间只留一个切换时先停掉另一个。四、实战演练让AI在Blender里变出一个红色金属球理论讲完来点真的。这个演练从零开始跑完你会在Blender里看到AI亲手创建的对象。启动 Blender确认插件已启用且侧边栏 BlenderMCP 面板显示连接状态。在 Claude 对话框里输入这句在场景中新建一个球体给它金属材质颜色调成红色。也可以先用简单句测试创建一个小球。等几秒切回 Blender 的 3D 视图——场景里出现了一个球体材质面板里多了一份红色金属材质同时 Claude 会回给你一条成功摘要。如果你把截图能力也开了还可以让AI看一眼当前视角截个图看看场景什么样。BlenderMCP 会把视口截图回传给AI实现AI看得见你在做什么的双向沟通。第一步指令偶尔会失败这是正常现象原样重发一次通常就过了。五、高频报错自查清单按出现频率排序连不上时别慌照着下面这张卡片按图索骥问题出在哪一环一眼就能定位。① uvx 找不到报错 spawn uvx ENOENT原因图形界面客户端不继承你终端的 PATH。解决终端里执行which uvxWindows 用where uvx拿到完整路径把command改成这个绝对路径Windows 直接改用上面的cmd /c写法。② 一直连接超时Blender 没反应原因八成是Blender端的服务器没起来或端口没对上。解决先回侧边栏确认点过 Connect to Claude再核对插件偏好里的端口与BLENDER_PORT一致最后看防火墙有没有放行 9876。③ 端口冲突两边客户端都连不上原因Cursor 和 Claude Desktop 的服务器同时开着。解决关掉其中一个只留一个跑。④ 第一条指令报错重发就好原因客户端首次加载工具列表时的偶发现象。解决原样重发指令即可不必排查。⑤ Apple SiliconM1/M2/M3上 uvx 编译报错原因默认尝试用 x86_64 的 Python 构建。解决在配置里加上args: [--python, 3.11-aarch64, blender-mcp]强制走 arm64。⑥ Docker/WSL 环境下连不上本机 Blender原因容器里访问不到宿主的localhost。解决配置里加env: { BLENDER_HOST: host.docker.internal }WSL2 则试127.0.0.1或 Windows 主机 IP。⑦ 请求太复杂导致超时原因一次塞了太多操作单条命令超过套接字等待时长。解决把大请求拆成几个小步骤一步步来。⑧ 想彻底关掉匿名遥测原因默认会上报工具名、耗时等匿名统计数据。解决启动命令前加BLENDER_MCP_DISABLE_TELEMETRYtrue或在配置env里设同样键值。六、还能玩出什么花三条进阶路线链路跑通只是起点接下来值得探索的方向有三个。其一远程控制Blender 跑在服务器上你在本地客户端指挥只需把BLENDER_HOST指向那台机器的地址。其二资产库接入在侧边栏勾选 Poly Haven 后AI 能直接下载 HDRI、纹理和模型Sketchfab、Hyper3D 等集成也支持在对话里搜索和生成资产。其三执行任意 Pythonexecute_blender_code允许AI直接在 Blender 里跑脚本能力上限极高但请务必先保存工程——这段代码真的能动刀。官方文档README.md 源码入口addon.pyBlender插件端、src/blender_mcp/MCP服务器端现在别收藏了就做一件事打开 Blender 装上插件、点下 Connect to Claude然后发一条最简单的指令创建一个小球。十分钟后你就正式踏入AI辅助3D建模的大门了。【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考