如何用一句对话驱动 Blender：mcp-for-blender MCP 桥梁完整安装与上手教程
【免费下载链接】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 听。mcp-for-blender 是一个基于 MCP（模型上下文协议）的开源社区插件，把你本地任意 LLM 客户端（Claude Desktop、Cursor、Codex、VS Code 等）和 Blender 连起来：你打一句话，它就在视口里改场景。这篇教程带你走完安装、连接、首次对话建模，完成后你也能用一句"把立方体改成红色金属"看到实时生效。
准备工作：装好 uv，四步打通客户端到 Blender 的链路
整个系统只有两个部分：装进 Blender 的插件 addon.py 负责在 Blender 内起一个 socket 服务并执行指令；MCP 服务 src/blender_mcp/server.py 负责把你的对话翻译成一条条指令。按下面四步装好即可。
- 准备 Blender— 装官方版 Blender 3.0 以上（推荐 4.x），用正常图形界面打开，后台模式不行。判断标准：能看到默认立方体和视口。
- 安装 uv— 用官方安装器装 uv，别用
pip install uv，否则可能缺少uvx命令。判断标准：终端运行uvx --version能返回版本号。 - 配置客户端— 在 AI 客户端的 MCP 配置里加一条 blender 启动项：
"command": "uvx"、"args": ["mcp-for-blender"]，以 Claude Desktop 的 Settings → Developer → Edit Config 为例。判断标准：配置保存不报错。旧包名blender-mcp仍可用，现有配置不用改。 - 安装插件— 终端运行
uvx mcp-for-blender install-addon，再到 Blender 的 Edit → Preferences → Add-ons 里搜索 "MCP for Blender"，勾选启用 "Interface: MCP for Blender"。判断标准：在视口按N打开侧边栏，能看到 MCP for Blender 选项卡。
首次实操：一句话搭出低多边形地牢场景
输入：重启 AI 客户端（让它加载新配置），打开 Blender，按N打开侧边栏，在 MCP for Blender 选项卡点 "Connect to Claude"。客户端里出现锤子图标，说明工具已就绪。
过程：在对话框输入"创建一个低多边形地牢，让一条龙守着金币"。请求经过 核心服务源码 被翻译成 Blender 指令：AI 用execute_blender_code在你的实时 Blender 里写并运行 bpy 代码，再用look截图检查结果，一步步推进。
结果：视口里能看到地牢、龙和金币逐个出现。比例不合适就直接追问"把龙缩小一点"或"给金币堆加一点暖色点光"，改动当场生效，不用从头重做。
连接之后还能做什么：资产、生成与截图自检
连上之后，MCP for Blender 提供的不只是建模型：
- 双向通信：AI 能创建、移动、缩放、删除物体，每个改动实时反映在视口，你可以当场检查、当场微调。
- 截图自检：
look支持视口、相机、线框拓扑、骨骼、动画序列等多种截图模式，"把镜头调低一点、加点侧光"这类指令是基于当前真实画面执行的。 - 资产下载：面板勾选 Poly Haven 后，一句"加个海滩 HDRI 环境"就能自动拉取环境、贴图和模型，资产是 CC0 免费授权，不需要 API 密钥。
- 模型生成：
generate_3d一次调用生成并导入 3D 模型；勾选 Poly Pizza（需免费 API key）还能导入上千个低多边形模型。 - 按需指南：涉及绑定、重拓扑、动画、关卡设计时，插件通过
get_guide只加载对应的工作流指南，见 src/blender_mcp/guides/。 - 安全模式：设置
BLENDER_MCP_SAFE_MODE=1，每个脚本执行前会先做检查，读写文件、调用外部程序这类危险操作会被拦下。
四个常见故障：ENOENT、端口抢占、超时与场景改坏
- 报
spawn uvx ENOENT- 现象：终端里
uvx明明可用，客户端却启动不了服务。 - 原因：从 Dock 或开始菜单启动的图形界面客户端不继承终端的 PATH，找不到
uvx。 - 处理：运行
which uvx（Windows 用where uvx）拿到完整路径，写进配置的command字段，再完全退出并重启客户端。
- 现象：终端里
- 连不上或反复断连
- 现象：客户端连不到 Blender，或第一条指令被吞、第二条才生效。
- 原因：你在终端手动跑了
uvx mcp-for-blender，和客户端启动的实例抢占端口；两个客户端同时接入也一样。 - 处理：结束手动启动的进程，服务启动交给客户端；Cursor 和 Claude Desktop 只保留一个接入。还不行就依次重启客户端和 Blender。
- 复杂请求超时
- 现象："搭一个完整海滩"这种大请求中途超时。
- 原因：大场景步骤多，单次请求链路太长。
- 处理：拆成两三句按顺序发：地面、岩石、植被。
- 下载 HDRI 时 Blender 卡住
- 现象：拉取 Poly Haven 素材时界面失去响应。
- 原因：下载跑在 Blender 主线程上，且分辨率每升一档体积约翻四倍。
- 处理：请求时直接指定"用 1k 或 2k 分辨率"，除非素材紧贴镜头。
另外记住一条边界：execute_blender_code允许 AI 在 Blender 里执行任意 Python，做实验前先保存文件，防止场景被改坏。
mcp-for-blender 把"菜单 → 参数 → 手动调整"的整套流程压缩成一句对话，从 LLM 到 Blender 的链路全程在你本地运行。更多 API 密钥配置、Docker 部署和完整故障排查，看仓库的 README.md；起步就选默认场景里的立方体，说一句"把这个立方体改成红色金属"。
【免费下载链接】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），仅供参考
