Blender MCP 接入 Claude Code：分步配置教程

简短回答

要在 Claude Code 中使用 Blender MCP：先安装 uv，运行 claude mcp add blender uvx mcp-for-blender，再用 uvx mcp-for-blender install-addon 安装 Blender 插件，在 Blender 偏好设置中启用 Interface: MCP for Blender，最后在 /mcp 中确认 blender 显示为已连接。之后 Claude 就能在你正在运行的 Blender 中搭建和修改场景。

这个服务器是 Siddharth Ahuja 开发的社区项目，在 mcp.so 上收录为 Blender MCP。它原名 blender-mcp，现在在 PyPI 上以 mcp-for-blender 发布。根据项目 README，使用 uvx blender-mcp 的旧配置仍然可用，但新安装应使用新名称。它是第三方集成，并非 Blender 官方产品。

Blender MCP 的工作原理

它由两部分组成，两者都必须在运行：

1. MCP 服务器（mcp-for-blender）。Claude Code 会通过 stdio 自动启动它，你不需要自己在终端里运行。
2. Blender 插件。它在 Blender 内部开启一个 socket 服务（默认在 localhost 的 9876 端口），接收命令并执行。

Claude Code 与 MCP 服务器通信，MCP 服务器再通过这个 socket 把每条命令转发给插件。如果 Blender 没打开或插件未启动，MCP 服务器能启动，但每次工具调用都会失败。

服务器提供的工具不多。主要有：execute_blender_code（在运行中的 Blender 里执行 Python）、look（查看视口、相机、多角度视图或渲染结果）、get_scene_info、search_assets 和 import_asset（Poly Haven、Sketchfab、Poly Pizza），以及 generate_3d（通过 Tripo、Hunyuan3D 或 Hyper3D Rodin 生成 AI 模型）。大部分建模工作由 Claude 编写 Blender Python 完成，并用 look 检查自己的结果。

前置条件

先安装 uv。README 明确要求没装好 uv 之前不要继续：

# 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"

安装后打开一个新终端，确认 uvx --version 能正常输出。

方案 A：一条命令自动安装

项目提供了一个安装脚本，它会找到你机器上的 MCP 客户端（包括 Claude Code），让你选择要配置哪些，添加一个 blender 条目，并安装和启用插件：

# macOS / Linux
curl -LsSf https://www.mcp-for-blender.com/install.sh | sh

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://www.mcp-for-blender.com/install.ps1 | iex"

如果已经装了 uv，运行 uvx mcp-for-blender setup 效果相同。它会保留你已有的配置，并为每个修改过的文件保存一份 .bak。和所有管道安装脚本一样，不放心的话先读一遍脚本内容。如果你想清楚知道改了什么，就用下面的手动步骤。

方案 B：在 Claude Code 中手动配置

第 1 步：添加 MCP 服务器

README 给出的命令：

claude mcp add blender uvx mcp-for-blender

这会把服务器保存到默认的 local 作用域，只在当前项目目录中出现。Blender 的工作很少绑定在某一个代码仓库上，所以大多数人希望它在所有项目中可用。这时用 user 作用域：

claude mcp add --scope user blender -- uvx mcp-for-blender

.mcp.json 中的 project 作用域条目如下：

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

关于作用域和审批的更多内容，见我们的 Claude Code MCP 指南。

第 2 步：安装 Blender 插件

uvx mcp-for-blender install-addon

这会把插件以 blender_mcp.py 的文件名复制到 Blender 插件目录，并打印写入的位置。如果你装了多个 Blender 版本，uvx mcp-for-blender addon-paths 会列出检测到的插件目录。

然后在 Blender 中：

1. 打开 Edit → Preferences → Add-ons。
2. 搜索 "MCP for Blender"，启用 Interface: MCP for Blender。
3. 如果没有出现，重启 Blender，或点击 Install… 选择复制过去的文件。

手动备选方案：从仓库下载 addon.py，通过同一个 Install… 按钮安装。

第 3 步：启动插件的服务

插件会在 Blender 打开时自动启动服务。要确认的话，在 3D 视口中按 N，打开侧边栏的 MCP for Blender 标签，如果没有运行就点击 Start MCP Server。在同一个面板里还可以勾选 Poly Haven 等可选素材源。

第 4 步：在 Claude Code 中验证

在终端运行：

claude mcp list

然后启动 claude 并运行 /mcp。你应该看到 blender 显示为已连接，并列出它的工具。显示已连接只能说明 Claude Code 能启动 MCP 服务器。要确认 Blender 这一侧也通了，可以先试一个小请求：

Use the blender MCP to get the scene info and list every object.

如果返回了默认的立方体、相机和灯光，说明整条链路都通了。

示例提示词

从小任务开始，让 Claude 用 look 工具检查自己的工作：

• 「创建一个低多边形地牢场景，里面有一条守护金罐的龙。」
• 「把这辆车改成红色金属质感，然后给我看一下相机视图。」
• 「用 Poly Haven 上一个阴天午后的 HDRI 给场景打光，并给墙面加上生锈金属贴图。」
• 「让相机对准场景，并改成等轴测视角。」
• 「用 Poly Pizza 的低多边形家具填满这个房间，每件大约 1 米高。」
• 「读取当前场景信息，并在这个仓库里用 three.js 做一个草图。」

最后一个例子正是 Claude Code 比聊天应用强的地方：它可以在同一个会话中读取 Blender 场景，并把代码写进你的项目。

可选设置

以下设置都来自 README。环境变量用 --env 传入，放在服务器名之后、-- 之前：

claude mcp add blender --env BLENDER_MCP_SAFE_MODE=1 -- uvx mcp-for-blender

要同时控制两个 Blender 实例，可以再添加一个带 --port 9877 的服务器，并在第二个 Blender 的插件面板中设置相同端口。

Sketchfab、Poly Pizza、Hyper3D 和 Hunyuan3D 的 API key 可以保存在 Edit → Preferences → Add-ons → MCP for Blender 中，重启后依然有效。

故障排查

如果 conda、pyenv 或 asdf 让 uv 选中了有问题的解释器，可以按 README 的建议固定 Python 版本：

claude mcp add blender --env UV_PYTHON_PREFERENCE=only-managed \
  -- uvx --python 3.11 mcp-for-blender

如果失败的安装一直重现，用 uv cache clean mcp-for-blender blender-mcp 清除缓存。

另外，同一时间只让一个客户端连接插件。如果 Claude Desktop 或 Cursor 也配置了同一个服务器，使用 Claude Code 时先把它们关掉。

安全

execute_blender_code 会在 Blender 中执行任意 Python，而插件的 socket 没有任何认证。三个习惯很有用：

• 每次会话前先保存 .blend 文件。 README 用粗体强调了这一点，确实应该这样做。
• 让 socket 只监听 localhost。 需要远程时用 SSH 隧道，不要把 BLENDER_HOST 直接指向远程机器。
• 开启安全模式，前提是你的脚本不需要访问文件或网络。

在你信任这套流程之前，保持 Claude Code 对 execute_blender_code 的工具审批。通用做法见我们的 MCP 安全最佳实践。

下一步

Blender MCP 很适合搭配浏览器类服务器，比如用 Playwright MCP 检查 three.js 导出效果；如果你的 3D 工作从设计稿开始，也可以搭配 Figma MCP。更多创意和开发工具可以在 MCP 服务器目录中浏览；如果你刚接触这个协议，可以先读一下什么是 MCP 服务器。