BlenderMCP安装与配置 MCP 插件从零到连通【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp你在对话框里敲下建一个低多边形地牢等十几秒回你的是一行连接报错关掉标签页去搜教程第一篇写着装个插件点 Connect 就行。BlenderMCP 是一个让任意大模型用自然语言直接驱动 Blender 3D 的开源 MCP 插件建物体、改材质、截视口图、执行 Python 代码。下面带你把客户端、服务端、插件这条链路全部装通出问题时能自己对号入座。BlenderMCP 是什么插件哪三类人该看BlenderMCP 把 Blender 接进大模型Claude、Cursor 里的模型都可以走的是模型上下文协议MCP——你可以把 MCP 理解成AI 操控软件的统一插座标准两边都接这个插座模型就能直接给 Blender 下指令。不想手动点几百次菜单的建模师想用 AI 加速原型迭代的工作流使用者被同类工具坑过、正在换方案的新用户整套东西只有两半跑在你电脑上的 MCP 服务端uvx blender-mcp拉起和住在 Blender 里的单文件插件addon.py。30 秒看懂 Blender MCP 通信链路动手前先存一张地图[AI 客户端 Claude/Cursor] --MCP-- [MCP 服务端 uvx blender-mcp] --TCP:9876-- [Blender 插件 addon.py]AI 客户端你说话的地方相当于发令台MCP 服务端中间的翻译官把自然语言翻成结构化命令TCP 端口 9876一条专线号码两端对上这个号才连得上addon.py 插件AI 伸进 Blender 工作台的手所有建模动作都在这里发生命令和结果以 JSON 来回传递{ type: create_object, params: { type: SPHERE, name: Ball } }你可以把这条 JSON 理解成一张工单指令写在工单上结果盖着章随回执返回。4 步连通 BlenderMCP装 uv、写配置、装插件、发第一句指令第 1 步装 uv拿到服务端启动器这一步装好后才能拉起 blender-mcp 服务。在终端里按系统执行其一# macOS brew install uv # Linux curl -LsSf https://astral.sh/uv/install.sh | sh# Windows powershell -c irm https://astral.sh/uv/install.ps1 | iex你可以把 uv 理解成 Python 项目的即插即用电闸它带来的uvx能直接启动 blender-mcp不用预装一堆依赖。Windows 装完把%USERPROFILE%\.local\bin加进 PATH然后重启终端。⚠️ 不要用pip install uv凑数因为它经常不生成uvx命令下一步客户端会直接报找不到命令。确认终端里执行uvx --version能打印版本号才算过关。第 2 步把 AI 客户端指向 blender-mcp 服务端这一步告诉客户端去哪找服务。打开 Claude 桌面版的设置 开发者 编辑配置在claude_desktop_config.json里贴上{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }你可以把这段配置理解成一份聘用单客户端一启动就雇uvx blender-mcp上岗客户端退出它就下班。⚠️ 改完配置必须完全退出客户端再重开因为客户端只在启动那一刻读一次这个文件。确认重启客户端后工具列表里出现 blender 相关的工具项。第 3 步把单文件插件 addon.py 装进 Blender这一步装的是 Blender 里那只手。先在终端克隆仓库拿到根目录下的addon.py整个插件就这一个文件git clone https://gitcode.com/GitHub_Trending/bl/blender-mcp然后在 Blender 里3.0推荐 4.x/5.x编辑 偏好设置 插件点安装…选中克隆目录里的addon.py勾选Interface: Blender MCP启用确认3D 视图按N键侧边栏出现BlenderMCP标签。第 4 步建立连接发出第一条指令并核对成功标志在侧边栏 BlenderMCP 标签里点Connect to Claude然后回到客户端输入创建一个低多边形地牢场景有火把和石柱。成功看三个标志一个都不能少Blender 侧边栏的 BlenderMCP 面板显示服务端运行中客户端里 Blender 条目旁出现锤子图标Blender 视口里开始冒出物体⚠️ 第一条指令偶尔没反应直接重发一次因为插件首次命令才会真正建立 socket 通道第一次超时需要重试。BlenderMCP 配置旋钮端口、环境变量与 Docker 怎么改先拿这张索引表定位你的情况你卡在哪看哪一节不想改只想知道默认行为默认值说明9876 端口被占端口冲突Blender 在 Docker/WSL/远程机器跨机器连接uvx 报编译/Python 冲突钉死 Python 版本不想发匿名统计关闭遥测默认值说明什么都不改时发生了什么BLENDER_HOST默认localhost服务端只找本机的 BlenderBLENDER_PORT默认9876插件侧边栏的端口输入框默认也是 9876单次 socket 请求超时上限 180 秒改任何一项前记住一条插件侧和服务端各持一份端口设置两边必须对得上。端口冲突9876 被占了怎么办触发条件侧边栏点 Connect 连不上或确认本机有别的程序占着 9876。改法客户端配置的env里加一行同时把插件面板 Port 改成同一个新号env: { BLENDER_PORT: 9877 }验证改完两边都点重连侧边栏回到运行中状态客户端指令有回音就说明对了。⚠️ 只改一边等于给对方打一个已经注销的号码永远没人接。跨机器连接Docker、WSL、远程主机怎么连触发条件Blender 跑在容器里、WSL 里或 MCP 服务端在另一台机器上。核心原则是 Blender 得监听在 MCP 进程够得着的地方。在配置里加env: { BLENDER_HOST: host.docker.internal, BLENDER_PORT: 9876 }WSL2 连 Windows 侧 Blender 时先试BLENDER_HOST127.0.0.1不通再换成 Windows 主机 IP。验证视口截图能正常返回——截图走 base64 回传不依赖共享临时目录所以远程场景也能用。钉死 Python 版本uvx 各种编译报错时怎么办触发条件机器上有 conda/pyenv 导致 Python 打架Apple Silicon 上还可能被拉去编 x86_64 的包。改法claude_desktop_config.json里这样写{ command: uvx, args: [--python, 3.11, blender-mcp], env: { UV_PYTHON_PREFERENCE: only-managed } }Apple Silicon 把版本号换成3.11-aarch64。如果还怀疑是旧包捣乱在终端执行uv cache clean blender-mcp uvx --refresh blender-mcp清缓存再刷新。验证客户端不再刷编译报错锤子图标正常出现。关闭遥测不想上报匿名统计怎么办触发条件你对匿名使用统计工具名、耗时、版本号这类字段有顾虑。改法在终端启动前或客户端配置的env里设export BLENDER_MCP_DISABLE_TELEMETRYtrue也可以在 Blender 里编辑 偏好设置 插件 Blender MCP里取消遥测勾选。验证设置后服务端不再有任何上报行为功能不受影响。三个能直接干的任务建场景、跑 Python、拉外部资源任务 A一句话建场景再让 AI 用截图自查验证标准AI 能根据截图说出场景里有什么并修正你指出的问题。确认侧边栏显示运行中发送创建一个低多边形地牢火把、石柱、一扇铁门追加一句用截图确认一下场景状态哪里不对就说把火把往左挪一点让 AI 再截图这个任务让你摸到的原理AI 不再盲改而是基于它亲眼看到的视口做验证和修正形成操作 → 截图 → 修正闭环。任务 B执行任意 Python 代码把立方体变成金色金属验证标准材质面板里出现 Principled BSDF 节点Metallic 为 1。⚠️execute_blender_code能跑任意代码等于把 Blender 控制权整个交给 AI——操作前先保存文件这是铁律。保存当前文件让 AI 新建一个立方体发送把这个立方体变成金色金属材质粗糙度 0.2切到材质面板核对节点它背后执行的逻辑这段也可以直接发给 AIimport bpy mat bpy.data.materials.new(nameGoldMaterial) mat.use_nodes True nodes mat.node_tree.nodes for node in nodes: nodes.remove(node) output nodes.new(typeShaderNodeOutputMaterial) principled nodes.new(typeShaderNodeBsdfPrincipled) mat.node_tree.links.new(principled.outputs[0], output.inputs[0]) principled.inputs[Base Color].default_value (0.9, 0.7, 0.1, 1) principled.inputs[Metallic].default_value 1.0 principled.inputs[Roughness].default_value 0.2这个任务让你摸到的原理你可以绕开工具层的封装直接写bpy代码自由度没有上限风险也没有上限。任务 C用 Poly Haven 资源管道组装一个场景验证标准世界环境变成 HDRI 光照场景里出现岩石和植被物体。侧边栏 BlenderMCP 面板勾选Poly Haven发送用 Poly Haven 的 HDRI、岩石和植被做个海滩氛围检查世界环境节点和新增物体推荐策略记一句具体现成物件找 Sketchfab通用素材找 Poly Haven定制需求用 Hyper3D Rodin / Hunyuan3D 生成。这个任务让你摸到的原理插件给 AI 预置了成套资源管道搜索、下载、应用到场景一条龙。连不上按这个顺序查4 条诊断链你看到的现象走哪条链客户端起不来报 spawn 错误链 1服务起来了连 Blender 超时链 2命令卡很久、超时、响应错乱链 3以上都试过链 4 终极三板斧链 1客户端根本起不来客户端日志里的原文可直接 CtrlF 对号入座failed to start: spawn uvx ENOENT终端执行which uvxmacOS/Linux或where uvxWindows→ 预期打印出完整路径把这个路径填进配置的commandWindows 用command: cmd, args: [/c, uvx, blender-mcp]写法 → 预期配置指向绝对路径完全退出客户端重启 → 预期工具列表出现 blender 条目兜底重装 uv用uvx --version重新确认。链 2能启动但连不上 Blender一直超时客户端可能回你这段服务端原文Timeout waiting for Blender response - try simplifying your request. If Blender is running headless (blender -b), commands never execute; run Blender with a GUI回 Blender 侧边栏确认插件显示运行中 → 预期有运行标记核对BLENDER_PORT与插件面板端口 → 预期两个数字一致查防火墙放行 9876确认 Blender 是带界面启动的blender -b后台模式下命令永远执行不了→ 预期指令有回音兜底断开再重连插件端口再核一遍。链 3命令卡很久、超时或响应错乱触发条件简单指令正常复杂请求超时或多个命令挤在一条 socket 上串线。把大任务拆成小指令分步发 → 预期每步都有回执单次上限 180 秒检查是否 Cursor 和 Claude 同时挂着 MCP 服务 → 同一时间只保留一个客户端侧边栏断开重连重建连接 → 预期后续命令恢复正常兜底继续简化请求或重启 Blender。链 4终极三板斧全试过了还是不通按顺序来重启 Blender 插件断开 → 重连完全重启 MCP 客户端把配置里的 blender 服务删掉重新添加这一套基本覆盖九成幽灵问题。跑通之后源码入口与今天就该做完的 5 件事三个可以继续挖的方向想看通信本质src/blender_mcp/server.py 里的BlenderConnection类锁加 socket 流保证命令不乱序想看插件端怎么注册面板和端口逻辑addon.py想核对功能清单与官方排错README.md 的 Troubleshooting 一节今天花 10 分钟做完这几件事☐ 终端验证uvx --version有版本号输出☐ 写好客户端 MCP 配置并重启确认锤子图标出现☐ 装好 addon.py侧边栏点 Connect确认运行中☐ 让 AI 建一个小场景并用截图自查一轮☐ 勾选 Poly Haven 或填好 Sketchfab Key完成一次资源导入哪一步卡住了直接带报错原文来贴报错原文、系统版本、客户端类型三样定位最快。【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考