BlenderMCP环境配置一篇搞定三步完成uvx命令行连接让AI真正上手你的3D场景【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp如果你的 AI 助手每次想帮你操作 Blender都卡在连接失败四个字上这篇 BlenderMCP 环境配置教程就是为你准备的。它不照搬官方文档而是用一次完整的上手经历带你从零装好插件、配好 uvx blender-mcp 命令行直到 AI 真正接管你的 3D 视口——全程只有三步每一步的坑都提前帮你填平。为什么你的 AI 助手总说看不见 Blender先别急着敲命令。90% 的连接失败不是配置写错而是没搞懂这条链路上有三个角色、两段通道你的 AI 客户端Claude / Cursor / VS Code │ ① MCP 协议stdio ▼ MCP 服务器uvx blender-mcp也就是 src/blender_mcp/server.py │ ② TCP 套接字默认 9876 端口 ▼ Blender 插件addon.pyBlender 内的套接字服务① 段负责AI 大脑和 MCP 服务器说话② 段负责 MCP 服务器和 Blender 说话。任何一段没接通AI 都只会回你一句连接失败。所以下面三幕就是分别打通这两段通道先让 Blender 端站起来再让 AI 端伸过手。第一幕让 Blender 先开口说话——三步环境准备本节要解决的问题把 Blender 变成一台等待指令的服务器。做完这一步你的 Blender 就能接收并执行来自外部的命令了。第一步装好 uv 包管理器uv 是启动 MCP 服务器的基础工具uvx命令就来自它。按你的系统选一条命令macOSbrew install uvWindowspowershell -c irm https://astral.sh/uv/install.ps1 | iex然后把%USERPROFILE%\.local\bin加进 PATHLinuxcurl -LsSf https://astral.sh/uv/install.sh | sh⚠️ 避坑不要用pip install uv安装它很可能不会生成uvx命令装完等于白装。第二步把 addon.py 装进 BlenderMCP 服务器本身不会操作 Blender真正动手的是 Blender 里的插件。安装顺序从仓库拿到addon.py文件打开 Blender进入编辑 偏好设置 插件点安装...选中addon.py勾选启用Interface: Blender MCP插件⚠️ 避坑请用正常的 GUI 版 Blender 会话不要用blender -b后台模式启动否则套接字服务和截图功能都会失效。第三步按下那个Connect按钮装好插件后在 3D 视图按N 键打开侧边栏找到BlenderMCP选项卡。如果之后想用 Poly Haven 素材库顺手勾选对应的复选框然后点击Connect to Claude。按钮按下后Blender 端就绪。此时它正安静地监听 9876 端口等待 MCP 服务器来敲门。第一幕完成接下来轮到 AI 那一端。第二幕让 AI 端伸出手——配置 MCP 服务器本节要解决的问题让 Claude、Cursor 这类 AI 客户端知道该用uvx blender-mcp命令去启动一个 MCP 服务器。这是整篇文章里环境配置的核心环节。Claude Desktop 配置示例打开Claude 设置 开发者 编辑配置在claude_desktop_config.json里加入{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }保存后完全退出并重新打开 Claude。启动后Claude 会自动调用uvx blender-mcp拉起 MCP 服务器无需你手动运行命令。Cursor 与 VS Code 的配置差异Windows 上的 Cursor 不直接继承终端 PATH需要绕一层cmd{ mcpServers: { blender: { command: cmd, args: [/c, uvx, blender-mcp] } } }VS Code 则与 macOS/Linux 的 Claude 写法一致直接command: uvx即可。两个环境变量决定去哪找 BlenderMCP 服务器通过环境变量知道 Blender 在哪这是 uvx blender-mcp 命令行最常用的两个参数环境变量默认值作用BLENDER_HOSTlocalhostBlender 套接字服务器的主机地址BLENDER_PORT9876套接字监听端口绝大多数本地场景不用改但在 Docker 或 WSL 里跑 MCP 服务器时Blender 不再和它在同一台机器上必须显式指定env: { BLENDER_HOST: host.docker.internal, BLENDER_PORT: 9876 }WSL2 连 Windows 版 Blender 时可以试试BLENDER_HOST127.0.0.1或你的 Windows 主机 IP。这一段的三个高频报错提前排掉报错一spawn uvx ENOENT。图形界面客户端不继承你终端里的 PATH找不到 uvx。先执行which uvxWindows 用where uvx拿到完整路径把那个绝对路径填到command里。报错二多个客户端同时开。千万别在 Cursor 和 Claude Desktop 里同时启动 MCP 服务器两个进程抢同一个端口必然冲突。同一时刻只保留一个。报错三Apple 芯片架构不匹配。M 系列 Mac 上如果出现 x86_64 构建错误在 args 里锁定 arm64 版本args: [--python, 3.11-aarch64, blender-mcp]第三幕第一次对话——用三句话验证全链路本节要解决的问题如何确认前两幕真的打通了。与其看日志不如直接让 AI 干点活。连接成功后Claude 界面会显示一个锤子图标代表 Blender 工具已激活这时直接发指令即可。指令一创建场景。这是最能检验全链路的命令创建一个低多边形场景地牢里有一条龙守护着一罐金子AI 会调用create_object等工具逐个在 Blender 里生成物体你甚至能在视口里看着它一点点搭出来。指令二改材质。检查 AI 对现有对象的控制力把这辆车改成红色金属质感对应到底层是set_texture或execute_blender_code在修改 Principled BSDF 节点的金属度、粗糙度和基础色不用你手动画节点。指令三让 AI亲眼看画面。视口截图是 BlenderMCP 最实用的能力之一AI 会调用get_viewport_screenshot截取当前视口然后根据画面继续调整。你会发现它不再盲操作了。⚠️ 避坑正式使用前先保存 Blender 工程。因为execute_blender_code会在 Blender 里执行任意 Python 代码功能极强也意味着没有安全网。⚠️ 避坑首次发送指令偶尔会超时这不是坏了是服务器第一次建立连接偏慢重试一次通常就好。另外复杂需求请拆成多个小指令逐步发送比一句话让 AI 做十件事成功率高得多。进阶让 AI 从造物体升级到找素材、生成模型基础链路通了之后BlenderMCP 还内置了几条素材快车道全部在 BlenderMCP 侧边栏或插件偏好设置里开关能力说明需要的配置Poly Haven下载 HDRI、纹理和现成模型岩石、植被等侧边栏勾选 Poly HavenSketchfab搜索并导入在线 3D 模型BLENDERMCP_SKETCHFAB_API_KEYHyper3D Rodin文字/图片直接生成 3D 模型BLENDERMCP_HYPER3D_API_KEY有免费试用额度Hunyuan3D腾讯的 3D 生成服务SecretId / SecretKey例如用 Poly Haven 的 HDRI 和植被做一个海滩氛围这类指令AI 会自动下载并摆放资产素材质量比自己拖模型高一个档次。顺带一提隐私项目会收集匿名的使用统计工具名、耗时、版本如果你介意在客户端配置里加上一行env: { BLENDER_MCP_DISABLE_TELEMETRY: true }即可彻底关闭敏感字段本来也会在上传前被剥离。收尾从能连上到顺手用的行动清单如果你一路跟到这里恭喜你的 AI 助手已经正式获得了操作 Blender 的工牌。离开前把这几点过一遍能帮你少走很多弯路改完任何配置记得完全退出并重启 AI 客户端这是最多人踩的坑同一时间只开一个 MCP 客户端端口冲突是最隐蔽的报错来源出问题时按重启 Blender 插件 → 重启 MCP 服务器 → 删除并重新添加 MCP 配置的顺序排查遇到 Python 版本冲突试试uv cache clean blender-mcp uvx --refresh blender-mcp清缓存想深入了解实现细节可以翻开项目的addon.py看 Blender 端如何开套接字服务或读src/blender_mcp/server.py看每个 MCP 工具是如何把指令封装成 JSON 发给 Blender 的README.md里有完整的工具清单和更新日志。如果这篇教程帮你省下了折腾时间不妨把它分享给同样在AI 3D路上摸索的朋友——下一个在视口里看着 AI 搭地牢的人可能就是他们。【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
