5分钟搞定BlenderMCP配置：环境变量、JSON接入与uvx启动一次到位

5分钟搞定BlenderMCP配置环境变量、JSON接入与uvx启动一次到位【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp每次想把 AI 接进 Blender结果都卡在连不上别急你不是一个人。BlenderMCP 是一个通过模型上下文协议MCP把 Blender 3D 和 Claude 等任意大模型连起来的社区插件配置好后你直接说人话就能建模、调材质、改场景。这篇攻略只讲一件事怎么在 5 分钟内把它配好、跑起来。卡在第一步先把这三件事装好动手前先检查三样东西缺一不可依赖最低版本作用Blender3.0推荐 4.x/5.x被控制的对象Python3.10运行 MCP 服务器uv最新版提供 uvx 命令一行启动服务器装 uv。Mac 用户直接跑brew install uvWindows 用户在 PowerShell 里执行powershell -c irm https://astral.sh/uv/install.ps1 | iex装完记得把%USERPROFILE%\.local\bin加进 PATH再重启终端。Linux 用户用一行脚本curl -LsSf https://astral.sh/uv/install.sh | sh别用pip install uv装它可能不会生成uvx命令后面会白折腾。✅ 完成标志终端输入uvx --version能打印出版本号。5分钟跑通第一个AI建模指令装完依赖走最短路径。先把仓库克隆到本地拿到addon.py插件文件git clone https://gitcode.com/GitHub_Trending/bl/blender-mcp然后打开 Blender编辑 偏好设置 插件 安装…选中addon.py勾选启用Interface: Blender MCP。✅ 完成标志Blender 偏好设置里能看到 Blender MCP 已勾选。接着给 Claude 桌面版加一段 JSON。打开Claude 设置 开发者 编辑配置 claude_desktop_config.json写入{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }保存后彻底退出并重启 Claude。回到 Blender按N键打开 3D 视图侧边栏切到BlenderMCP选项卡点Connect to Claude。连接成功后Claude 对话框里会出现一个锤子图标说明 AI 已经握住了 Blender 的遥控器。✅ 完成标志Claude 里出现锤子图标输入在原点创建一个红色球体Blender 里真的长出一个球。3个配置参数决定你能不能连上连不上时八成是这几个参数没对上。它们全部支持环境变量控制默认值如下环境变量默认值什么时候要改BLENDER_HOSTlocalhost服务器跑在远程机器、Docker 或 WSL 里时BLENDER_PORT9876端口被占用、或插件端改了监听端口时BLENDER_MCP_DISABLE_TELEMETRY未设置想关掉匿名使用统计时设为true终端里这样设export BLENDER_HOSTlocalhost export BLENDER_PORT9876但在 Claude Desktop 这类 GUI 客户端里环境变量要写进 JSON 的env字段。比如服务器跑在 Docker 里、Blender 在宿主机上时{ mcpServers: { blender: { command: uvx, args: [blender-mcp], env: { BLENDER_HOST: host.docker.internal, BLENDER_PORT: 9876 } } } }WSL2 连 Windows 版 Blender 时把BLENDER_HOST换成127.0.0.1或 Windows 主机的 IP 再试。✅ 完成标志改完配置重启客户端锤子图标能正常出现。别踩这5个坑1. 报spawn uvx ENOENTGUI 客户端不继承终端 PATH。先执行which uvxWindows 用where uvx拿到完整路径填进 JSON 的command字段Windows 也可以写成command: cmd, args: [/c, uvx, blender-mcp]。2. 同时开了两个客户端Cursor 和 Claude Desktop 别同时挂同一个 MCP 服务器端口会打架。一次只开一个。3. 别手动跑uvx blender-mcp。服务器由客户端自动拉起手动跑反而容易占住端口还干扰调试。4. Apple 芯片报架构错误M 系列 Mac 上uvx如果去编译 x86_64 版本就在args里强制指定 arm64 Pythonargs: [--python, 3.11-aarch64, blender-mcp]5. 第一条指令超时首次调用经常要预热重试一次就好复杂任务拆成多步小指令比一次憋个大招稳。再玩大一点远程主机与多编辑器联动配置跑通后这些玩法能把体验直接拉满。换个编辑器JSON 基本不用改。Cursor、VS Code 的配置和 Claude 几乎一致只有 Windows 版 Cursor 需要包一层cmd /c。Claude Code 命令行用户更省事一行注册claude mcp add blender uvx blender-mcp接上资产库。在插件侧边栏勾选 Poly HavenAI 就能帮你下载 HDRI、贴图和模型Sketchfab、Hyper3D、Hunyuan3D 等集成按需开启API 密钥存在 Blender 插件偏好设置里重启不丢。管好遥测。项目默认会上报匿名的工具使用统计想彻底关掉启动时加个环境变量BLENDER_MCP_DISABLE_TELEMETRYtrue uvx blender-mcp修 Python 版本冲突。conda/pyenv 混用导致版本不对时固定用 3.11 并清一次缓存args: [--python, 3.11, blender-mcp], env: { UV_PYTHON_PREFERENCE: only-managed }uv cache clean blender-mcp uvx --refresh blender-mcp接下来你可以做这5件事让 AI 生成一个低多边形地牢有条龙守着金币的场景用 Poly Haven 的 HDRI 和植被搭一个海滩氛围让它把这辆车改成红色金属材质把一张参考图丢给 AI重建整个 Blender 场景用 Hyper3D 一句话生成花园小矮人的 3D 模型踩坑时优先翻项目自带的排障章节官方文档README.md。配好之后多试几轮提示词你的 AI 建模工作流就正式开张了。【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考