BlenderMCP参数配置从零到一环境变量、JSON配置与uvx命令行实战指南【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp深夜两点你盯着终端里第 N 次超时的连接报错旁边是已经写好的提示词在场景里放一颗红色金属质感的球。配置改了一百遍Blender 就是不搭理 Claude——这不是你的错而是没摸清 BlenderMCP 这套参数配置 命令行的组合拳。BlenderMCPblender-mcp是一款社区插件作用是让任何 LLM 通过自然语言实时操控 Blender 3D建物体、改材质、调灯光、看视口截图全程不用碰鼠标。这篇文章就带你从环境变量到uvx blender-mcp命令行把每个旋钮都拧明白。一句话看懂原理它是一座翻译桥把 Blender 想象成一位只会说方言的老匠人把 Claude 想象成一位只会普通话的客户。BlenderMCP 就是站在中间的同声传译——MCP 服务器负责把客户的话翻成匠人能懂的指令匠人干完活再把结果翻回去。链条是这样的LLM 客户端 ⇄ MCP 服务器src/blender_mcp/server.py⇄ TCP 套接字 ⇄ Blender 插件addon.py两侧默认通过localhost:9876这个对话窗口交流。窗口开在哪、朝谁开就是参数配置要管的事。最短路径三步让 AI 第一次摸到Blender别急着研究参数先把链路跑通亲眼看到成果再说。三条命令以内你就能让 Claude 在 Blender 里凭空变出一颗球。第一步装好 uv 包管理器# macOS brew install uv # Linux curl -LsSf https://astral.sh/uv/install.sh | sh # WindowsPowerShell powershell -c irm https://astral.sh/uv/install.ps1 | iex⚠️ 别用pip install uv——它可能不会生成uvx命令后面全白搭。第二步让 AI 客户端认识 MCP 服务器以 Claude Desktop 为例打开claude_desktop_config.json写入{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }第三步装插件点连接从仓库下载addon.pygit clone https://gitcode.com/GitHub_Trending/bl/blender-mcp后取根目录文件即可在 Blender 里走编辑 偏好设置 插件 安装勾选启用 Interface: Blender MCP。然后按N打开 3D 视图侧边栏切到BlenderMCP选项卡点Connect to Claude。看到 Claude 界面出现锤子图标说明桥通了——现在直接说创建一个低多边形地牢看它表演。参数速查表认识这几个关键旋钮链路跑通后就该搞清楚每个旋钮是干什么的了。BlenderMCP 的参数藏在两类地方环境变量给 MCP 服务器看和JSON 配置给 AI 客户端看。参数默认值作用BLENDER_HOSTlocalhostMCP 服务器去连 Blender 的主机地址BLENDER_PORT9876套接字通信端口与插件侧保持一致BLENDER_MCP_DISABLE_TELEMETRYfalse设为true可彻底关闭匿名遥测BLENDERMCP_SKETCHFAB_API_KEY空Sketchfab 模型搜索的 API KeyBLENDERMCP_HYPER3D_API_KEY空Hyper3D Rodin 生成 3D 模型的 API KeyBLENDERMCP_HUNYUAN3D_SECRET_ID/SECRET_KEY空腾讯 Hunyuan3D 的密钥对BLENDERMCP_HUNYUAN3D_API_URLhttp://localhost:8081Hunyuan3D 服务地址场景一本机直连默认情况啥都不用设。默认localhost:9876就是为Blender 和 AI 客户端在同一台电脑准备的。场景二Docker / WSL 里跑 AI 客户端Blender 在宿主机上客户端在容器里localhost就指不到对方了。把 JSON 里的env段补上env: { BLENDER_HOST: host.docker.internal, BLENDER_PORT: 9876 }WSL2 连 Windows 版 Blender 时试127.0.0.1或 Windows 主机 IP。场景三OpenCode 这类用配置块的客户端{ mcp: { blender-mcp: { type: local, command: [uvx, blender-mcp], enabled: true, environment: { BLENDER_HOST: localhost, BLENDER_PORT: 9876 } } } }小提示API Key 这类敏感参数也可以直接在 Blender 插件偏好设置里填重启不丢比到处 export 省心。实战走一遍uvx blender-mcp 命令行从启动到出活先破除一个误区大多数时候你不该手动运行uvx blender-mcpAI 客户端会替你拉起这个进程。手动跑只在两种场合有意义命令行类客户端以及排查问题。命令行客户端怎么接Claude Code 一条命令搞定claude mcp add blender uvx blender-mcp想手动验证服务器能起来直接跑uvx blender-mcp看到类似 Starting MCP server 的日志说明包装好了、依赖没炸。此时它会以 stdio 模式等待客户端喂话按CtrlC退出即可。连上之后怎么用在对话里下指令例如创建一个低多边形场景地牢中有一条龙守护着一罐金子把场景里的小车改成红色金属材质如果你好奇 AI 到底往 Blender 里发了什么可以打开终端看 MCP 服务器的日志——每次操作都会记录工具名、耗时和结果。想深入直接读src/blender_mcp/server.py里面就是 MCP 工具和套接字通信的全部实现Blender 侧的接收逻辑在addon.py。想更硬核地控场还可以在对话里让 AI 执行 Python 代码块比如直接建材质节点并赋给选中物体——execute_blender_code工具就是干这个的。⚠️ 它能在 Blender 里跑任意 Python动手前记得保存文件。避坑手册新手最容易踩的 7 个坑⚠️坑 1报错spawn uvx ENOENTGUI 客户端不继承终端 PATH找不到uvx。用which uvxWindows 用where uvx拿到完整路径写进配置的command字段Windows 也可以写成command: cmd, args: [/c, uvx, blender-mcp]。⚠️坑 2改了配置却没生效配置文件改完必须完全退出并重启客户端不是关窗口是彻底退出进程。⚠️坑 3多个客户端同时连千万别在 Cursor 和 Claude Desktop 里同时跑 blender 服务器——端口冲突、串响应问题千奇百怪。一次只开一个。⚠️坑 4Apple Silicon 架构报错M 系列 Mac 上uvx可能尝试为 x86_64 编译导致报错强制指定 arm64 版本args: [--python, 3.11-aarch64, blender-mcp]⚠️坑 5第一条命令总是失败这是 BlenderMCP 的老毛病插件刚启动或首次握手时第一条命令常超时。别慌原样再发一次通常就成了。⚠️坑 6在blender -b后台模式里跑插件插件在无界面后台模式下套接字和视口工具不工作。请用正常 GUI 模式打开 Blender。⚠️坑 7复杂操作超时一次生成整个城市容易踩 180 秒套接字超时。把大任务拆成小步先建地牢再放龙再补金子逐条确认。进阶收尾下一步玩什么链路通了、坑也填了接下来这几件事能让你玩得更野让 AI 用上外部资产库在侧边栏勾选 Poly HavenAI 就能直接下载 HDRI、贴图和岩石植被模型AI 直接生成 3D 模型配置 Hyper3D Rodin 或 Hunyuan3D 密钥一句生成一个花园精灵雕像就能出模型远程主机模式Blender 放在一台高性能机器上AI 客户端在另一台——这正是BLENDER_HOST存在的意义关掉遥测在意隐私就设BLENDER_MCP_DISABLE_TELEMETRYtrue或去掉插件偏好里的遥测勾选。想深入源码重点看这几处MCP 服务器入口src/blender_mcp/server.py、遥测与配置src/blender_mcp/config.py、Blender 侧插件addon.py以及仓库里的README.md、TERMS_AND_CONDITIONS.md插件首次使用会要求确认条款。踩到新坑就去仓库 Issues 里翻一翻多半已经有人替你趟过了。现在回到你的 Blender——打开侧边栏点下 Connect然后对 AI 说出你今晚真正想要的那句话吧。【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考