用 mcp-for-blender 让智能体直接建模 Blender：安装、连接与场景生成实操

# macOS
brew install uv

# Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows（PowerShell）
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

uv 负责按需拉起 mcp-for-blender 的 Python 运行环境，你不需要自己装任何 Python 依赖。装完在新终端里跑 uv --version 确认可用。官方 README 特意强调用上面的官方安装器，别用 pip install uv 的方式装，避免环境混乱。

为什么要多这一层运行时：MCP Server 是一个常驻的 Python 进程，客户端每次启动都会通过 uvx 拉起它，uv 会自动处理虚拟环境与依赖解析——你不需要手动建 venv，也不需要关心系统 Python 版本。这也是后面所有配置里命令都写成 uvx 开头的原因：客户端调用的不是全局安装的程序，而是 uv 按声明即时准备好的运行环境。Windows 用户安装后如果当前终端提示找不到 uv 命令，重开一个终端窗口即可，安装器写入的 PATH 只对新进程生效。

{
  "mcpServers": {
    "blender": {
      "command": "uvx",
      "args": ["mcp-for-blender"]
    }
  }
}

把这段加进 Claude Desktop 的 MCP 配置（Settings → Developer → Edit Config）。注意两点：一是包名变更的兼容性——老的 uvx blender-mcp 依然能跑，已有配置不用改，新装统一用 mcp-for-blender；二是 uvx 安装在用户 PATH 下，部分 GUI 应用启动时读不到完整 shell PATH，配置后客户端里看不到 Blender 工具的话，重启一下客户端应用试试。改完保存并重启 Claude Desktop，对话输入框的工具入口里应该能看到 Blender 相关工具。

# 插件文件在 GitHub 仓库根目录：addon.py
# 仓库地址：github.com/ahujasid/blender-mcp（即 mcp-for-blender 项目）

# 安装路径（Blender 4.x）：
# Edit → Preferences → Add-ons → 右上角下拉菜单 → Install from Disk
# 选择下载的 addon.py，然后在列表里勾选启用 "Blender MCP"

# 启动连接：
# 视口按 N 打开侧栏 → BlenderMCP 标签 → 启动 MCP 服务器
# 默认监听 127.0.0.1:9876

装好插件后，在 Blender 的 N 面板里找到 BlenderMCP 标签，点启动，让插件服务跑起来——这一步是让「Blender 侧」准备好接活，顺序上建议先启动插件、再开始对话。面板里还有 PolyHaven 资源库的开关：打开后智能体可以直接从 PolyHaven 拉 HDRI、材质与模型（走网络下载），场景质感会上一个台阶，但生成会变慢，原型阶段可以先关着。

帮我在 Blender 里搭一个简约客厅：
一张布艺沙发、一张木质茶几、一盏落地灯，
暖色灯光，整体浅色系，
相机正对沙发，给一个 35mm 的视角

智能体会先调用场景信息工具看当前状态，再逐步创建对象、赋予材质、打灯、摆相机，每一步你在视口里实时可见。生成过程中它可以自己追问、自己纠错——比如发现两个物体重叠就挪开。想要质感，就在指令里明确开启 PolyHaven 并说明风格（「用 PolyHaven 的木地板材质」）；想要快，就说「先用基础材质快速出布局，后面再精修」。

# 三类高频迭代指令模板
# 精修单个对象：
「把沙发改成浅灰色布艺材质，加一点粗糙度」
# 场景级调整：
「整体灯光调暗 30%，落地灯作为主光源」
# 结构性修改：
「茶几换成圆形的，直径 0.8 米，位置不变」

描述对象时带上可度量的属性（颜色、尺寸、位置关系、材质类型），智能体的执行准确率会明显提高；「好看一点」「高级一些」这类形容词它只能猜。视口里看到不对的地方，直接指着说「刚才那个柜子太高了，降到一米六」——它有场景信息工具，能定位到你说的对象。如果某一步反复出错，让它先「输出当前场景的对象清单」对齐状态，再继续。

# 1) 客户端侧：uv 是否可用、包是否能拉起
uv --version
uvx mcp-for-blender --help

# 2) Blender 侧：插件服务是否已启动（N 面板确认）
# 3) 客户端日志：Claude Desktop 的 MCP 日志里看 blender server 状态

最常见的失败是顺序问题：Blender 插件服务没启动，客户端侧 Server 起了也连不上对象。其次是 GUI 应用 PATH 问题导致 uvx 找不到，重启客户端或用绝对路径可解。项目本身开源免费，不需要额外的 API Key——模型能力由你的客户端订阅提供，工具执行全在本机。还有一类隐蔽问题值得提前知道：同一个 .blend 文件不要在两个客户端会话里同时连着改，插件服务是单实例的，并发指令会互相踩踏，轻则对象错位，重则指令丢失败无提示。