如何彻底搞定BlenderMCP连接配置从环境搭建到uvx命令行实战的完整指南【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcpBlenderMCP 是一款基于模型上下文协议MCP的开源工具它能让你用自然语言命令 Claude 等大模型实时操控 Blender 3D——建物体、调材质、生成截图、执行 Python 脚本一条提示词全部搞定。连接配置是入门最大的坎这篇文章就带你从零到一跑通全流程。先讲一个凌晨两点的真实事故有个开发者照着教程把插件装好了AI 那边也显示已连接可对着 Blender 下达创建球体的指令场景里却空无一物。他翻遍日志发现MCP 服务器和插件各连各的端口根本没对上话。更隐蔽的是他的编辑器里残留着一个旧版本的 MCP 配置每次启动都悄悄占用了 9876 端口。这类故事每天都在发生。配置看着对和真的对之间往往隔着几个你根本不会注意的细节。接下来我们把这些细节一次讲透。先看懂它内部是怎么牵手的BlenderMCP 由两个组件组成Blender 插件addon.py在 Blender 内部创建一个基于套接字socket的服务器负责接收并执行命令MCP 服务器src/blender_mcp/server.py实现模型上下文协议通过 TCP 连接到 Blender 插件同时向 AI 客户端暴露工具。数据流向大致是AI 客户端 --MCP-- MCP 服务器 --TCP:9876-- Blender 插件理解了这条链路你就明白了任何一环没对上AI 都会假装正常但实际失效。这也是为什么我们总强调配置要逐环检查。五步快速打通第一根连接第一步装好 uv 包管理器不同系统命令不同Mac 用户直接brew install uvWindows 用户用安装脚本即可。注意不要用pip install uv它有可能不生成uvx命令后续会多出很多麻烦。第二步把 MCP 服务器写进客户端配置以 VS Code 为例在 MCP 配置文件中加入{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }如果你用的是 OpenCode配置略有不同可以显式写上环境变量{ mcp: { blender-mcp: { type: local, command: [uvx, blender-mcp], enabled: true, environment: { BLENDER_HOST: localhost, BLENDER_PORT: 9876 } } } }第三步安装并启用 Blender 插件下载addon.py在 Blender 中进入编辑 偏好设置 插件 安装选中该文件后启用Interface: Blender MCP。第四步在侧边栏点击连接打开 3D 视图侧边栏没显示就按N键切到 BlenderMCP 选项卡。下图红框位置就是插件的控制面板连接按钮就在这里第五步发送你的第一条指令连接成功后AI 客户端会出现该工具的标记。试着说一句创建一个红色金属质感的立方体如果场景里出现了立方体恭喜整条链路已经打通。把连接拧紧环境变量配置清单BlenderMCP 支持通过环境变量自定义连接行为常用清单如下环境变量默认值作用BLENDER_HOSTlocalhostBlender 套接字服务器的主机地址BLENDER_PORT9876套接字服务器监听端口BLENDER_MCP_DISABLE_TELEMETRY空设为true可完全关闭匿名遥测BLENDERMCP_SKETCHFAB_API_KEY空Sketchfab 模型搜索的密钥BLENDERMCP_HYPER3D_API_KEY空Hyper3D 生成模型的密钥BLENDERMCP_HUNYUAN3D_SECRET_ID空混元 3D 生成的访问凭据跨容器场景是最常见的配置需求。比如在 Docker 或 WSL 里运行 MCP 服务器而 Blender 跑在宿主机上就得把主机指向宿主机export BLENDER_HOSThost.docker.internal export BLENDER_PORT9876 uvx blender-mcpWSL2 连 Windows 版 Blender 时可以试试BLENDER_HOST127.0.0.1或宿主机 IP。好消息是截图通过 base64 返回不需要共享临时文件路径远程场景省心不少。命令行实战uvx 的正确打开方式uvx blender-mcp这行命令背后有个容易误解的点它通常由客户端自动拉起不建议你手动运行。手动启动反而可能造成端口被占用导致客户端那边连不上。如果客户端报spawn uvx ENOENT说明它找不到uvx命令——图形界面客户端不会继承终端的 PATH。解决方法是先找到完整路径which uvx # macOS / Linux where uvx # Windows然后把输出路径填进配置的command字段。Windows 还有一种稳妥写法command: cmd, args: [/c, uvx, blender-mcp]。Apple Silicon 用户如果遇到架构不匹配uvx试图为 x86_64 构建强制指定 arm64 的 Python 即可args: [--python, 3.11-aarch64, blender-mcp]遇到 Python 版本冲突时可以指定 3.11 并清理缓存后重试uv cache clean blender-mcp uvx --refresh blender-mcp用命令行客户端的朋友可以直接执行claude mcp add blender uvx blender-mcp一条命令完成注册。踩坑手册连接失败排查清单把高频问题整理成了一张速查表照着顺序排查基本都能解决症状可能原因处理方法连接超时插件未启动或防火墙拦截确认侧边栏显示已连接放行 9876 端口端口冲突Cursor 和 Claude Desktop 同时运行同一时间只保留一个客户端第一次指令失败首次握手不稳定重试一次即可复杂操作一直转圈单条指令过重拆成多个小步骤逐条下发改完配置不生效客户端未彻底退出完全退出并重新启动客户端进阶玩法从能用到好用✅关闭遥测想保护隐私启动时加上环境变量BLENDER_MCP_DISABLE_TELEMETRYtrue uvx blender-mcp或在客户端配置的env中声明。✅让 AI 看见场景插件支持视口截图AI 可以基于当前画面调整构图和材质这个能力对照着参考图建模类需求尤其好用。✅接入资产与生成服务勾选 Poly Haven 可下载 HDRI、纹理和模型配置 Hyper3D 或混元 3D 密钥后可以直接让 AI 生成 3D 资产Sketchfab 则支持搜索并导入现成模型。✅远程主机MCP 服务器可以部署在远程机器上配合BLENDER_HOST指向目标地址实现远程操控 Blender。新手最容易踩的五个误区手动运行uvx blender-mcp抢占端口导致客户端连不上。用pip install uv安装结果发现没有uvx命令。在后台模式blender -b下跑 Blender套接字和视口功能不可用必须用正常 GUI 会话。改完配置只刷新页面而没有彻底退出重启客户端。多个客户端同时挂着 MCP 服务器端口冲突让人排查到崩溃。下一步行动清单按五步快速打通完成首次连接跑通创建红色金属立方体这个最小用例。逐一对照环境变量清单把适合自己场景的变量写进配置。尝试一次视口截图指令体验 AI 可视化协作。想深入理解实现可执行git clone https://gitcode.com/GitHub_Trending/bl/blender-mcp阅读源码。收藏官方文档README.md升级插件时记得同步更新客户端配置。连接通了剩下的就是想象力的事。祝你玩得开心【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考