# Blender MCP + Claude —— 完整配置与使用指南

Blender MCP 通过 **Model Context Protocol(MCP)** 把 [Blender](https://www.blender.org/)  和 Claude 连接起来,让 Claude 能够直接用自然语言在 Blender 里创建、修改和渲染 3D 模型。本指南涵盖让 Claude 和 Blender 协同工作所需的全部内容——从最初的安装,到进阶的提示词技巧。

无论你用的是 **Claude Desktop**、**Claude Code** 还是 **Anthropic API**,这篇都适用。整个配置大约需要 5–10 分钟,而且不花钱——Blender MCP 是免费开源的。

## 前置条件[](https://blendermcp.org/zh-cn/setup/claude#%E5%89%8D%E7%BD%AE%E6%9D%A1%E4%BB%B6)

开始之前,请确认你已经有:

-   **Blender 3.0 或更新的版本** —— [从 blender.org 下载](https://www.blender.org/download/) 。推荐 Blender 4.x。
-   **Python 3.10 或更新的版本** —— 一般系统自带。用 `python3 --version` 检查。
-   **Claude 桌面应用** —— [从 claude.com 下载](https://claude.com/download) (也可以用 Claude Code 命令行)。
-   **一个 Anthropic 账号** —— 免费额度可用,但处理复杂场景时 Pro 的效果更好。

> 继续之前必须先安装 **uv 包管理器**。没有它,MCP 服务端无法运行。

## 第 1 步:安装 uv 包管理器[](https://blendermcp.org/zh-cn/setup/claude#%E7%AC%AC-1-%E6%AD%A5%E5%AE%89%E8%A3%85-uv-%E5%8C%85%E7%AE%A1%E7%90%86%E5%99%A8)

Blender MCP 服务端通过 `uvx`(uv 工具链的一部分)运行。按你的平台安装:

**macOS**

**Windows**

**Linux**

### macOS

```bash
brew install uv
```

验证安装:

```bash
uv --version
```

### Windows

打开 PowerShell 并运行:

```powershell
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
```

然后把 uv 加入 PATH(之后可能需要重启 Claude Desktop):

```powershell
$localBin = "$env:USERPROFILE\.local\bin"
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$userPath;$localBin", "User")
```

### Linux

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

> uv 的完整安装文档(英文):[docs.astral.sh/uv/getting-started/installation](https://docs.astral.sh/uv/getting-started/installation/)

## 第 2 步:配置 Claude Desktop(claude\_desktop\_config.json)[](https://blendermcp.org/zh-cn/setup/claude#%E7%AC%AC-2-%E6%AD%A5%E9%85%8D%E7%BD%AE-claude-desktopclaude_desktop_configjson)

打开 Claude Desktop,进入 **Settings → Developer → Edit Config**,它会打开你的 `claude_desktop_config.json` 文件。加入 Blender MCP 服务端:

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

保存文件,然后**重启 Claude Desktop** 让改动生效。

> **配置文件在哪里?**
>
> -   **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
> -   **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

### 改用 Claude Code[](https://blendermcp.org/zh-cn/setup/claude#%E6%94%B9%E7%94%A8-claude-code)

如果你更习惯 Claude Code 命令行,一条命令就能加上 MCP 服务端:

```bash
claude mcp add blender uvx blender-mcp
```

不需要手动编辑配置文件——Claude Code 会自动处理。

## 第 3 步:安装 Blender 插件[](https://blendermcp.org/zh-cn/setup/claude#%E7%AC%AC-3-%E6%AD%A5%E5%AE%89%E8%A3%85-blender-%E6%8F%92%E4%BB%B6)

这个 Blender 插件会在 Blender 内部启动一个 socket 服务,用来接收来自 Claude 的指令。

### 下载插件[](https://blendermcp.org/zh-cn/setup/claude#%E4%B8%8B%E8%BD%BD%E6%8F%92%E4%BB%B6)

从 [Blender MCP 的 GitHub 仓库](https://github.com/ahujasid/blender-mcp) 下载 `addon.py`。

### 在 Blender 中安装[](https://blendermcp.org/zh-cn/setup/claude#%E5%9C%A8-blender-%E4%B8%AD%E5%AE%89%E8%A3%85)

打开 Blender → **Edit → Preferences → Add-ons** → 点击 **“Install…”** → 选择刚下载的 `addon.py` 文件。

### 启用插件[](https://blendermcp.org/zh-cn/setup/claude#%E5%90%AF%E7%94%A8%E6%8F%92%E4%BB%B6)

勾选 **“Interface: Blender MCP”** 前面的复选框,把它启用。

## 第 4 步:启动 MCP 服务端[](https://blendermcp.org/zh-cn/setup/claude#%E7%AC%AC-4-%E6%AD%A5%E5%90%AF%E5%8A%A8-mcp-%E6%9C%8D%E5%8A%A1%E7%AB%AF)

插件装好之后,还需要把连接建立起来:

### 打开 BlenderMCP 面板[](https://blendermcp.org/zh-cn/setup/claude#%E6%89%93%E5%BC%80-blendermcp-%E9%9D%A2%E6%9D%BF)

在 Blender 的 3D 视图里按 **N** 打开侧栏,然后找到 **“BlenderMCP”** 标签页。

### 启用 Poly Haven(可选)[](https://blendermcp.org/zh-cn/setup/claude#%E5%90%AF%E7%94%A8-poly-haven%E5%8F%AF%E9%80%89)

如果你想使用 [polyhaven.com](https://polyhaven.com/)  上免费的 HDRI、贴图和 3D 模型,把 Poly Haven 的复选框打开。

### 点击 “Connect to Claude”[](https://blendermcp.org/zh-cn/setup/claude#%E7%82%B9%E5%87%BB-connect-to-claude)

这一步会启动 Blender 内部的 socket 服务。你应该会看到一条确认连接成功的状态提示。

> **同一时间只运行一个 MCP 服务端实例。** 如果你在 Cursor 和 Claude Desktop 里同时跑着 MCP 服务端,连接会互相冲突。只选一个。

## 第 5 步:用 Claude 做出第一个 3D 模型[](https://blendermcp.org/zh-cn/setup/claude#%E7%AC%AC-5-%E6%AD%A5%E7%94%A8-claude-%E5%81%9A%E5%87%BA%E7%AC%AC%E4%B8%80%E4%B8%AA-3d-%E6%A8%A1%E5%9E%8B)

打开 Claude Desktop(或 Claude Code)。你应该能看到一个**锤子图标**,表示 MCP 工具已经可用。试试这些提示词:

-   _“做一个低多边形的地牢场景,里面有一条守着一罐金币的龙”_
-   _“用 Poly Haven 的 HDRI 和模型做出海滩的氛围”_
-   _“做一个悬在蓝色立方体上方的红色金属球”_
-   _“布置影棚灯光,并把相机对准场景,用等距视角”_
-   _“通过 Hyper3D 生成一个花园地精的 3D 模型”_

Claude 可以创建物体、设置材质、布置灯光、下载 Poly Haven 素材、通过 Hyper3D Rodin 生成 3D 模型,甚至在 Blender 里执行任意 Python 代码。

> **小技巧:** 从简单的请求开始,再逐步增加复杂度。比起逐条描述操作步骤,描述你想要的最终结果,Claude 的表现更好。复杂场景一次做不成的话,就拆成几个小的提示词。

## 常见问题排查[](https://blendermcp.org/zh-cn/setup/claude#%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98%E6%8E%92%E6%9F%A5)

### ”Connection refused” 或 “MCP server not found”[](https://blendermcp.org/zh-cn/setup/claude#connection-refused-%E6%88%96-mcp-server-not-found)

-   确认 Blender 插件那边的服务已经在运行(看 BlenderMCP 侧栏面板)
-   改完配置文件后重启 Claude Desktop
-   确认 uv 已安装:`uv --version`
-   **不要**自己在终端里手动运行 `uvx blender-mcp` —— 这件事由 Claude Desktop 负责

### ”Timeout” 超时错误[](https://blendermcp.org/zh-cn/setup/claude#timeout-%E8%B6%85%E6%97%B6%E9%94%99%E8%AF%AF)

-   复杂的操作可能比预期更久。试着把请求写简单一些。
-   把大场景拆成几个小的、按顺序执行的提示词。

### 第一条指令没反应[](https://blendermcp.org/zh-cn/setup/claude#%E7%AC%AC%E4%B8%80%E6%9D%A1%E6%8C%87%E4%BB%A4%E6%B2%A1%E5%8F%8D%E5%BA%94)

这是一个已知的小毛病。连接之后的第一条指令有时候发不出去。再发一条,通常就正常了。

### Poly Haven 素材加载不出来[](https://blendermcp.org/zh-cn/setup/claude#poly-haven-%E7%B4%A0%E6%9D%90%E5%8A%A0%E8%BD%BD%E4%B8%8D%E5%87%BA%E6%9D%A5)

Claude 在 Poly Haven 集成上的表现不太稳定。如果不奏效,把需求写得更具体一些(例如:_“从 Poly Haven 下载一张森林 HDRI,并把它设为世界背景”_)。

### Windows 上的 PATH 问题[](https://blendermcp.org/zh-cn/setup/claude#windows-%E4%B8%8A%E7%9A%84-path-%E9%97%AE%E9%A2%98)

如果 Claude 找不到 `uvx`,请确认 uv 的 bin 目录已经在系统 PATH 里。修改过 PATH 之后要重启 Claude Desktop。

## Claude Desktop、Claude Code 和 API —— 该用哪个[](https://blendermcp.org/zh-cn/setup/claude#claude-desktopclaude-code-%E5%92%8C-api--%E8%AF%A5%E7%94%A8%E5%93%AA%E4%B8%AA)

| 方式 | 适合谁 | 配置难度 |
| --- | --- | --- |
| **Claude Desktop** | 视觉创作者、新手 | 最简单——图形界面配置 |
| **Claude Code** | 开发者、习惯用终端的人 | 简单——一条命令行 |
| **Anthropic API** | 自定义集成、自动化 | 进阶——需要写代码 |

对大多数人来说,**Claude Desktop** 是推荐的起点。它提供可视化的对话界面,并且会自动管理 MCP 服务端的生命周期。

如果你本来就习惯用终端,想把 Blender MCP 和写代码的流程结合起来,**Claude Code** 更合适。

**Anthropic API** 给你完整的编程控制权,适合在 Blender MCP 之上搭建自动化的 3D 资产流水线或自定义工具。

## 效果不错的示例提示词[](https://blendermcp.org/zh-cn/setup/claude#%E6%95%88%E6%9E%9C%E4%B8%8D%E9%94%99%E7%9A%84%E7%A4%BA%E4%BE%8B%E6%8F%90%E7%A4%BA%E8%AF%8D)

下面这些提示词来自 Blender MCP 社区的实际使用:

| 提示词 | 它会做什么 |
| --- | --- |
| _”做一个地牢里的低多边形场景,有一条龙守着一罐金币”_ | 包含多个物体的完整场景构建 |
| _”用 Poly Haven 的 HDRI、贴图和模型做一个海滩”_ | 用真实素材做环境设计 |
| _”给它一张参考图,据此搭出一个 Blender 场景”_ | 基于参考图的场景创建 |
| _”通过 Hyper3D 生成一个花园地精的 3D 模型”_ | AI 生成 3D 模型 |
| _”读取当前场景的信息,并据此写一个 Three.js 页面”_ | 把场景导出到网页 |
| _”把这辆车改成红色金属材质”_ | 修改材质 |
| _”把相机对准场景,并改成等距视角”_ | 相机与渲染设置 |

## Blender MCP 是免费的吗?[](https://blendermcp.org/zh-cn/setup/claude#blender-mcp-%E6%98%AF%E5%85%8D%E8%B4%B9%E7%9A%84%E5%90%97)

**是的。** Blender MCP 完全免费且开源([MIT 许可证](https://github.com/ahujasid/blender-mcp) )。Blender 本身也是免费的。唯一的开销是你的 Claude 订阅——免费额度可以用,但在复杂的 3D 场景上,Claude Pro(每月 20 美元)的效果要好得多。

如果你更愿意自己部署模型,而不是为云端模型付费,可以看我们的 [Ollama 本地部署指南](https://blendermcp.org/zh-cn/setup/ollama)。那是一条进阶路线:需要一块够用的 GPU,配置和维护的工作量大得多,而且在复杂的 Blender 任务上,效果通常不如领先的云端模型。

## Blender MCP 是怎么工作的?[](https://blendermcp.org/zh-cn/setup/claude#blender-mcp-%E6%98%AF%E6%80%8E%E4%B9%88%E5%B7%A5%E4%BD%9C%E7%9A%84)

Blender MCP 由两个部分组成:

1.  **Blender 插件**(`addon.py`)—— 在 Blender 内部启动一个 socket 服务,监听指令
2.  **MCP 服务端**(`server.py`)—— 在 Claude 的 MCP 协议和 Blender 的 socket 服务之间做翻译

当你在 Claude 里发送一条消息时,MCP 服务端会接收它、转换成 Blender 指令、通过 socket 发给插件,再把结果返回。想看技术层面的详细解释,可以读我们的 [MCP 服务端架构详解](https://blendermcp.org/zh-cn/server)。

## 另一种选择:把整个任务交给智能体[](https://blendermcp.org/zh-cn/setup/claude#%E5%8F%A6%E4%B8%80%E7%A7%8D%E9%80%89%E6%8B%A9%E6%8A%8A%E6%95%B4%E4%B8%AA%E4%BB%BB%E5%8A%A1%E4%BA%A4%E7%BB%99%E6%99%BA%E8%83%BD%E4%BD%93)

上面的步骤给 Claude 的是底层的 Blender 工具:由 Claude 规划每一步,再自己调用 Blender。如果你更想把整个任务交出去,3D-Agent 的 MCP 服务端走的是另一条路。它是一个本地 MCP 服务端,只有一个工具 `3d_agent(task)`:Claude Code 或 Claude Desktop 把任务发给它,比如”做一座带发光灯的低多边形灯塔”,3D-Agent 自己的智能体就会在你打开的 Blender 场景里把它做出来。它包含在 3D-Agent 的付费 Ultra 套餐里(没有免费版),每次调用算作一次 3D-Agent 提示词。

这是一种取舍,而不是替代:Blender MCP 免费,让你逐步掌控每一步;3D-Agent 则把整个任务从你的客户端手里接过去。

> 本页的文字步骤是完整的,不看视频也能配完。想对照着看的话,下面这段完整的安装演示录屏在 YouTube 上,只有英文、没有中文字幕;在你点开之前,本页不会加载它的任何内容。

[

在 YouTube 上观看(英文,能否访问取决于你自己的网络)

### 完整安装与演示

](https://www.youtube.com/watch?v=-k3bw1M0Ixg)

想要一个开箱即用的 Blender AI 工具,不必依赖外部 API 或订阅?可以看看我们自己的付费应用 3D-Agent —— AI 和更完整的工具集都已包含在内,也不需要配置 MCP。

[了解 3D-Agent →](https://3d-agent.com/zh-cn?utm_source=blendermcp.org&utm_medium=referral&utm_campaign=zh_cn_pilot_v1&utm_content=zh_setup_claude_top)

用的是别的 AI 客户端?

[Cursor 配置 →](https://blendermcp.org/zh-cn/setup/cursor)[VSCode 配置 →](https://blendermcp.org/zh-cn/setup/vscode)[ChatGPT 配置 →](https://blendermcp.org/zh-cn/setup/chatgpt)[Gemini 配置 →](https://blendermcp.org/zh-cn/setup/gemini)[Ollama 配置 →](https://blendermcp.org/zh-cn/setup/ollama)

## 常见问题

### 可以免费把 Blender MCP 和 Claude 一起用吗?

可以。Blender MCP 免费且开源,Blender 也是免费的。你只需要一个 Claude 账号——免费额度足够做基础任务,但复杂场景下 Claude Pro(每月 20 美元)效果更好。Ollama 是进阶的替代方案:把模型部署在你自己的 GPU 上,而不是为云端模型付费,代价是配置和维护的工作量大得多,而且在复杂的 Blender 任务上效果通常更弱。

### Blender MCP 和 Claude 是怎么配合的?

Blender MCP 通过 Model Context Protocol 把 Claude 连接到 Blender。Blender 插件启动一个 socket 服务,MCP 服务端在 Claude 和 Blender 之间充当桥梁。Claude 发出的自然语言指令会被翻译成 Blender 的操作——创建物体、设置材质、布置灯光等等。

### Claude Desktop 支持 MCP 服务端吗?

支持。Claude Desktop 原生支持 MCP。进入 Settings → Developer → Edit Config 就可以添加 MCP 服务端。你也可以用 Claude Code 命令行,它通过 'claude mcp add' 命令支持 MCP。

### 哪些 AI 模型能配合 Blender MCP?

Blender MCP 最初是为 Claude 设计的,但同样可以配合 Cursor、VSCode(通过 Cline / Roo Code)、Google Gemini CLI,以及通过 Ollama 使用的本地模型。任何支持 Model Context Protocol 的 AI 客户端都能连上 Blender MCP。

### 怎么配置 Blender MCP?

安装 uv 包管理器,把 Blender MCP 服务端的配置写进 Claude Desktop 的配置文件(claude\_desktop\_config.json),从 GitHub 仓库下载并安装 Blender 插件,然后在 Blender 侧栏点击 'Connect to Claude'。整个过程大约 5–10 分钟。

### Blender MCP 能做什么?

Blender MCP 可以创建、修改和删除 3D 物体;设置和修改材质;布置灯光和相机;从 Poly Haven 下载素材;通过 Hyper3D Rodin 生成 3D 模型;在 Blender 中执行任意 Python 代码;以及导出场景数据。它支持 Blender 3.0 及以上版本,并可搭配多种 AI 客户端。

配置还是不顺利?这正是开源那条路的代价 —— AI 客户端、模型和配置都要你自己选、自己维护。我们自己的付费应用 3D-Agent 则把 AI 和整套工具一并包含在内。 [对比 Blender MCP 与 3D-Agent →](https://blendermcp.org/zh-cn/compare/blender-mcp-vs-3d-agent)
