BlenderMCP 配置完全指南：4 步接通 AI 与 Blender

BlenderMCP 配置完全指南4 步接通 AI 与 Blender【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcpBlenderMCP 是一个开源项目通过模型上下文协议MCP把 Blender 接到支持 MCP 的大模型客户端上让你用自然语言直接创建、修改 3D 场景。本文只围绕 BlenderMCP 配置这一件事按装环境 → 装插件 → 配客户端 → 连上并试指令的顺序走一遍。全程只需要 uvx 一条命令和一段 JSON不需要写代码。它怎么工作BlenderMCP 是双组件架构AI 客户端不直接操作 Blender指令以 JSON 形式在 TCP 套接字上往返。两端各自独立没有硬编码耦合。Blender 插件addon.py装在 Blender 内启动一个本地套接字服务器收到指令后调用 Blender 执行并回传结果MCP 服务器src/blender_mcp/server.py由客户端以uvx blender-mcp拉起实现模型上下文协议把 AI 的意图翻译成插件能理解的指令跑通最小可用环境版本要求一行说清Blender 3.0 及以上推荐 4.x、Python 3.10 及以上外加 uv 包管理器。安装 uv 包管理器macOSbrew install uvWindows在 PowerShell 中执行完成后把%USERPROFILE%\.local\bin加入 PATH并重启客户端powershell -c irm https://astral.sh/uv/install.ps1 | iex其他系统按 uv 官方安装文档 操作。 不要用pip install uv它可能不会生成uvx命令。安装并启用 Blender 插件从仓库下载 addon.py在 Blender 中依次打开 编辑 偏好设置 插件 安装...选中刚下载的 addon.py勾选启用 Interface: Blender MCP启用后在 3D 视图按 N 打开侧边栏切换到 BlenderMCP 选项卡计划使用 Poly Haven 资产的话先勾选对应复选框再点击 Connect to Claude。MCP 服务器会由客户端自动拉起无需在终端手动运行。配置你的 AI 客户端三个常用客户端的差异集中在命令写法上客户端command 写法说明Claude Desktopuvx经 Settings Developer Edit Config 编辑claude_desktop_config.jsonCursorWindowscmdargs 加/cWindows 下需包一层写成cmd /c uvx blender-mcpVS Codeuvx在 MCP 市场搜索 blender-mcp 一键安装即可配置与下方 JSON 相同任选一个客户端以下面这份 Claude Desktop 的配置为准其余客户端按键名照搬{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }改完配置后完全退出并重启客户端。若提示找不到uvx说明图形界面客户端读不到终端 PATH用which uvxmacOS/Linux或where uvxWindows取完整路径填进command字段。Blender MCP 环境变量BLENDER_HOST 与 BLENDER_PORTuvx blender-mcp本身没有任何直接参数连接目标完全由两个环境变量决定变量默认值何时需要修改BLENDER_HOSTlocalhostBlender 跑在别的机器或容器里例如 Docker 下填host.docker.internalBLENDER_PORT9876端口被占用或同一台机器要区分多个 Blender 实例export BLENDER_HOSThost.docker.internal export BLENDER_PORT9876设置完成后启动方式不变客户端自动运行uvx blender-mcp你不需要手工敲这条命令。连上之后先试这三个连接建立后把下面三条指令原样发给 AI由浅入深地验证能力建一个低多边形地牢里面有一条龙看守着一堆金子 —— 覆盖建模与布景的基础链路用 Poly Haven 的 HDRI 加上岩石和植被搭一个海滩场景 —— 验证资产下载需先在侧边栏勾选 Poly Haven用 Hyper3D 生成一个花园侏儒的 3D 模型 —— 验证 AI 建模能力排错速查表现象可能原因处理动作连接超时插件服务器未启动9876 端口被防火墙拦截单次请求过于复杂确认侧边栏显示已连接放行端口把指令拆成若干小步骤分步发送两个客户端抢占连接同时在 Cursor 和 Claude Desktop 中运行了 MCP 服务器端口冲突 ⚠️同一时间只保留一个客户端先断开另一个再继续通信错误插件与服务器状态不同步依次重启 Blender 插件和 MCP 服务器仍失败就在客户端中删除 blender 服务器后重新添加spawn uvx ENOENT客户端找不到 uvx将which uvx/where uvx输出的完整路径填入command更多资料完整功能清单Sketchfab、Hunyuan3D、远程主机等与更新记录见 README.md许可协议见 LICENSE。【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考