ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

MCP for Blender 安装实战:三步接通 AI 与 Blender,一句话在视口里造出 3D 场景

MCP for Blender 安装实战:三步接通 AI 与 Blender,一句话在视口里造出 3D 场景 MCP for Blender 安装实战三步接通 AI 与 Blender一句话在视口里造出 3D 场景【免费下载链接】mcp-for-blenderCommunity plugin to control Blender 3D with any LLM of your choice. Not affiliated with the official Blender Foundation.项目地址: https://gitcode.com/GitHub_Trending/bl/mcp-for-blender你在 Claude 里敲下建一个低多边形小屋转了十几秒弹回来一行failed to start: spawn uvx ENOENT换 Cursor 再试Blender 侧边栏停在 Not connected指令石沉大海视口纹丝不动。问题多半不在你而在链路的某一环没对上——uv 没装好、客户端没找到uvx、插件没连上、端口两边不一样每一种长出来的症状都长得像AI 不行。MCP for Blender 是一个开源插件它在你常用的大模型客户端Claude、Cursor、Codex 都行和 Blender 之间架一座桥你打自然语言它在 Blender 里建物体、改材质、跑 Python、从素材库拉资源。这篇文章带你把这座桥架通直到第一条指令真的在视口里变出东西。先认识这条流水线后厨传菜的比喻装东西之前先花一分钟记住下面这张表。后面所有排错都是拿它对照菜卡在哪一桌。组件你可以把它理解成干的事AI 客户端点菜顾客你开口下单的地方菜好不好吃看它传话传得准不准MCP 服务端mcp-for-blender传菜服务员把你的口头要求写成一张张 JSON 点菜单端到传菜口端口 9876传菜口编号服务员和厨师各写一个号两边一致菜才递得过去Blender 插件addon.py掌勺厨师在 Blender 内部真正动手建网格、调节点、执行代码JSON 命令与回执点菜单和回条下单是{type: ..., params: ...}回来是status为success或error你看到的一切都以它为凭据第一关把服务端从客户端拉起来这一关只解决一件事客户端一启动能自己把 mcp-for-blender 服务端带起来。安装 uv拿到 uvx 启动器目标系统里有一个随时可用的uvx命令它是后面一切的地基。分平台选一条装官方安装脚本别走 pip# macOS brew install uv # Linux curl -LsSf https://astral.sh/uv/install.sh | sh# Windows装完把 %USERPROFILE%\.local\bin 加进 PATH再重开终端 powershell -c irm https://astral.sh/uv/install.ps1 | iex⚠️ 别用pip install uv凑数它常常不生成uvx命令还会把 uv 塞进客户端看不见的虚拟环境里等你下一步配置好了客户端照样报找不到命令。确认终端里跑uvx --version能吐出一个版本号才算过这一小步。在客户端配置里挂上服务目标客户端配置里多一个blender条目。以 Claude 桌面版为例打开设置 → 开发者 → 编辑配置把下面这段合进claude_desktop_config.jsonCursor、VS Code 的 MCP 配置同构照搬即可{ mcpServers: { blender: { command: uvx, args: [mcp-for-blender] } } }注意 PyPI 包名已从blender-mcp改为mcp-for-blender老配置里的旧名还能跑但新装请用新名。⚠️ 两个易踩的坑一是配置文件只在客户端启动那一刻读一次改完必须彻底退出重开Windows 上要从系统托盘退出关窗口不算二是同一时间只挂一个客户端跑这个服务两个客户端抢同一条 socket回执会串到别人头上。确认重启后客户端的工具列表里出现blender条目、旁边带锤子图标第一关通关。第二关把厨师请进 Blender目标Blender 里装上插件并能在侧边栏找到它的操作面板。一行命令装插件uvx mcp-for-blender install-addon它把插件复制进 Blender 的 addons 目录文件名blender_mcp.py打印落盘位置并给被替换的旧文件留一份.bak。⚠️ 如果它找不到你机器上的 Blender走手动路线先git clone https://gitcode.com/GitHub_Trending/bl/mcp-for-blender然后打开 Blender编辑 → 偏好设置 → 插件 → 安装…选仓库根目录下的addon.py整个插件就是这一个文件装完启用Interface: MCP for Blender。确认3D 视口按N键侧边栏出现MCP for Blender标签页能看到 Port 输入框默认 9876和Connect to MCP server按钮。第三关打通传菜口发出第一条指令目标插件开始监听端口客户端的点菜单能收到回条。在侧边栏MCP for Blender标签里按需要勾选资源库比如免密钥的 Poly HavenPort 保持默认9876点Connect to MCP server回客户端发一句建一个低多边形地牢要火把和石柱⚠️ 第一条指令偶尔超时没回音属已知行为socket 通道是首条命令到达时才真正建起来的。直接重发一次别急着怀疑前面装错了。确认通关判定三条齐了才算过面板从 Not connected 变成 Connected on port 9876客户端有正常的工具调用回执视口里开始冒物体。到这里桥已经架完。实战三道菜从建场景到导出 GLB三道菜按敢放手的程度递进每道都有验证标准和一句原理提炼。菜一一句话建场景再让 AI 回看一眼验证标准AI 能根据视口截图说出场景里有什么并按你的要求修正。确认面板显示 Connected on port 9876发送创建一个低多边形地牢火把、石柱、一扇铁门追加用视口截图确认一下场景状态哪里不满意就说把火把往左挪一点再让它截图核对⚠️ 截图走 base64 回传场景很大时会慢一些属正常现象别在途中重发。如果你用的是 Codex可以顺手装它带在仓库里的插件git clone之后执行codex plugin marketplace add ./blender-mcp/integrations/codex重启后在插件目录安装MCP for Blender聊天旁边直接开一块实时视口点一下物体就能挂到下一条消息里回看一眼都省了。原理提炼AI 改完会回头看视口建模就从盲改变成了操作 → 截图 → 修正的闭环。菜二跑任意 Python把立方体变成金色金属验证标准材质面板里 Principled BSDF 节点 Metallic 为 1、Roughness 为 0.2。先把当前文件存盘铁律下面会解释为什么让 AI 新建一个立方体发送把这个立方体变成金色金属材质粗糙度 0.2切到材质面板核对节点参数⚠️execute_blender_code能执行任意 Python等于把 Blender 的控制权整个交给 AI。翻车时唯一的后悔药就是你存的那个文件所以动手前先存盘更保守一点可以在服务端配置里设BLENDER_MCP_SAFE_MODE1让脚本先过一遍安全检查再执行被拦下的脚本会带着原因退回给 AI 重试。原理提炼工具层之外还能直接写bpy自由度没有上限风险也没有上限——存盘是这两者的交换条件。菜三用 Poly Haven 铺一个海滩再导出 GLB验证标准世界环境换成 HDRI 光照场景里多出岩石和植被物体最后拿到一个能打开的.glb文件。侧边栏勾选Poly HavenCC0 免费、免密钥、无账号勾上就是全部设置发送用 Poly Haven 的 HDRI、岩石和植被做个海滩氛围检查世界环境节点和新增物体追加把当前场景导出为 GLB让export_scene把文件交给下游应用⚠️ 素材下载跑在 Blender 主线程上UI 会卡到下载完成这是现象不是死机另外分辨率每上一档体积大约翻四倍离镜头远的素材只要 1k 或 2k别贪 4k。原理提炼插件把搜索、下载、应用做成了成套管道AI 全程不用碰任何网页。改参数之前先对号入座你的情况看哪一节什么都不想动只要默认行为默认值一览9876 被占或想同时开两个 Blender换端口两端必须同号服务端要跑在 Docker / 另一台机器Docker 跨机器连接uvx 起服务时报编译错、Python 打架钉死 Python 版本一条数据都不想上报关掉遥测默认值一览BLENDER_HOST默认localhost服务端只找本机的 BlenderBLENDER_PORT默认9876插件面板的 Port 输入框默认也是 9876单次 socket 请求的超时上限 180 秒遥测默认只发一条最小匿名用量记录工具名、耗时、版本号之类你的提示词、代码、截图默认不收集除非你在插件偏好里明确勾选同意换端口两端必须同号触发条件9876 被别的程序占了或你并排开着两个 Blender 实例。改法客户端配置的env里加BLENDER_PORT: 9877或在args里加--port 9877命令行参数优先于环境变量然后把插件面板的 Port 改成同一个号。两条路都走通后两边都要重连。验证面板显示 Connected on port 9877指令有回条。⚠️ 只改一边等于往一个已停机的号码拨电话永远没人接。Docker 跨机器连接触发条件MCP 服务端跑在容器或另一台机器里Blender 本体仍然在你自己机器上容器只托管服务端。改法仓库根目录自带 Dockerfiledocker build -t mcp-for-blender .之后镜像默认BLENDER_HOSThost.docker.internalmacOS/Windows 的 Docker Desktop 开箱就能够到宿主机的 Blender。Linux 上这个域名不存在改用 host 网络{ command: docker, args: [run, -i, --rm, --networkhost, -e, BLENDER_HOSTlocalhost, mcp-for-blender] }验证让 AI 截一张视口图能正常返回说明整条链路是通的。⚠️ 插件的 socket 没有认证也没有加密任何够得到这个端口的人都能在你的 Blender 里跑 Python——跨机器请保持 localhost SSH 隧道别把端口直接挂到网络上。钉死 Python 版本触发条件机器上有 conda/pyenv或新 CPython 缺现成 wheeluvx 一拉服务就刷编译报错。改法在客户端配置里锁住解释器并让 uv 只用自己管理的 Python{ command: uvx, args: [--python, 3.11, mcp-for-blender], env: { UV_PYTHON_PREFERENCE: only-managed } }--python 3.11仍满足包要求的3.103.11 有现成 wheel基本绕开编译。仍怀疑旧缓存捣乱就清掉重拉uv cache clean mcp-for-blender blender-mcp uvx --refresh mcp-for-blender验证客户端不再刷编译错误锤子图标正常出现。关掉遥测触发条件连那条最小匿名用量记录都不想发。改法终端export DISABLE_TELEMETRYtrue后再启动或写进客户端配置的envDISABLE_TELEMETRY: true。验证服务端日志不再有任何上报动作功能完全不受影响。卡住了先抄报错原文再走对应路线你看到的现象走哪条路线客户端起不来报 spawn 错误路线一服务起来了Blender 一直超时路线二简单指令正常、复杂请求超时或卡住路线三上面全试过了终极动作路线一客户端根本起不来报错原文CtrlF 对号入座failed to start: spawn uvx ENOENT终端执行which uvxmacOS/Linux或where uvxWindows→ 预期打印出 uvx 的完整路径把这个绝对路径填进配置的commandWindows 也可写成command: cmd, args: [/c, uvx, mcp-for-blender]→ 预期配置指向的是绝对路径。原理在此图形界面客户端不继承终端的 PATH终端里明明能跑和客户端找不到可以同时为真彻底退出客户端再重启 → 预期工具列表出现 blender 条目兜底重装 uv重新确认uvx --version有版本号。路线二服务在跑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 or via xvfb-run -a blender instead回 Blender 侧边栏看面板 → 预期显示 Connected on port … 而不是 Not connected不是的话先点Connect to MCP server核对面板 Port 与BLENDER_PORT/--port的取值 → 预期两边数字一致确认 Blender 是带界面启动的 →blender -b后台模式下命令永远不会执行换 GUI 启动或xvfb-run -a blender→ 预期指令开始有回条兜底侧边栏Disconnect再重连一次端口数字再抄一遍。路线三简单指令正常复杂请求卡死触发条件单条简单命令都正常一到复杂请求就超时或多条命令挤在一条 socket 上互相串线。把大任务拆成小指令分步发单条上限 180 秒→ 预期每步都有回执检查是不是 Cursor 和 Claude 同时挂着这个服务 → 预期同一时间只有一个客户端挂着它侧边栏断开重连 → 预期后续命令恢复正常兜底继续简化请求再不行重启 Blender。终极动作插件侧重连Disconnect → Connect to MCP server客户端彻底退出再启动把配置里的 blender 条目删掉、重新添加这套基本覆盖九成幽灵问题。往深里挖的三个入口addon.py插件全部家底——侧边栏面板、端口逻辑、按type字段分发命令的路由都在这一个文件里src/blender_mcp/server.pyBlenderConnection类在这里一把锁加一条 socket 流保证两条命令不会在传菜口上撞车README.mdEnvironment Variables 与 Troubleshooting 两节是官方口径的最终依据今天就能勾完的清单☐ 终端uvx --version能打印出版本号☐ 客户端 MCP 配置写好并彻底重启工具列表出现带锤子图标的 blender 条目☐uvx mcp-for-blender install-addon装好插件侧边栏出现 MCP for Blender 标签☐ 面板显示 Connected on port 9876第一条指令在视口里变出物体☐ 让 AI 建一个小场景用视口截图自查一轮☐ 勾选 Poly Haven 完成一次 HDRI 或模型导入再用export_scene导出 GLB哪一步卡住了直接带报错原文来报错原文、操作系统版本、客户端类型这三样凑齐定位最快。【免费下载链接】mcp-for-blenderCommunity plugin to control Blender 3D with any LLM of your choice. Not affiliated with the official Blender Foundation.项目地址: https://gitcode.com/GitHub_Trending/bl/mcp-for-blender创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表