# 如何在 VSCode 中配置 Blender MCP(Roo Cline / Cline)

Visual Studio Code 不像 Cursor 那样内置 MCP 支持。要在 VSCode 里使用 **Blender MCP**,你需要一个兼容 MCP 的扩展,比如 **Cline** 或 **Roo Code**。这两个扩展都提供 AI 对话界面,并且能连接到 Blender MCP 这类 MCP 服务端。本指南把完整配置走一遍,让你可以在 VSCode 里用自然语言创建和修改 Blender 场景。

## 前置条件[](https://blendermcp.org/zh-cn/setup/vscode#%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` 检查。
-   **Visual Studio Code** —— [从 code.visualstudio.com 下载](https://code.visualstudio.com/) 。
-   **Cline** 或 **Roo Code** —— 支持 MCP 的扩展,在 VSCode 扩展市场里安装。

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

## 第 1 步:安装 uv 包管理器[](https://blendermcp.org/zh-cn/setup/vscode#%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(之后可能需要重启 VSCode):

```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 步:在 VSCode 中安装 Cline 或 Roo Code[](https://blendermcp.org/zh-cn/setup/vscode#%E7%AC%AC-2-%E6%AD%A5%E5%9C%A8-vscode-%E4%B8%AD%E5%AE%89%E8%A3%85-cline-%E6%88%96-roo-code)

VSCode 本身不带 MCP 支持,你需要一个充当 MCP 客户端的扩展:

**方案 A:Cline**

1.  打开 VSCode,进入扩展面板(`Ctrl+Shift+X` 或 `Cmd+Shift+X`)
2.  搜索 **“Cline”**
3.  安装 Cline 扩展(作者 Cline)
4.  如果提示重启,就重启 VSCode

**方案 B:Roo Code**

1.  打开 VSCode 的扩展面板
2.  搜索 **“Roo Code”**
3.  安装 Roo Code 扩展
4.  如果提示重启,就重启 VSCode

这两个扩展都会加上一个 AI 对话面板,并支持连接 MCP 服务端。选哪个看你自己的习惯;Blender MCP 的配置写法是一样的。

## 第 3 步:配置 Blender MCP 服务端[](https://blendermcp.org/zh-cn/setup/vscode#%E7%AC%AC-3-%E6%AD%A5%E9%85%8D%E7%BD%AE-blender-mcp-%E6%9C%8D%E5%8A%A1%E7%AB%AF)

把 Blender MCP 服务端加入你的 MCP 配置。格式和 Claude Desktop 那边一样。

**用 Cline:** 打开 Cline 的设置(通常在 Cline 面板或命令面板里),添加一个 MCP 服务端。

**用 Roo Code:** 打开 Roo Code 的设置,在配置区域里添加一个 MCP 服务端。

**手动配置:** 如果你的扩展使用配置文件(例如 `mcp.json`,或写在用户设置里),加入:

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

> **另一种快捷安装方式:** Blender MCP 的 GitHub 仓库上可能有一个 “Install in VS Code” 徽章。点击它可以在兼容的扩展里预先配好 MCP 服务端,底层写入的配置和上面这段是一样的。

改完 MCP 设置后,重启 VSCode(或重新加载窗口),这样 Blender 服务端才会被识别。

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

这个 Blender 插件会在 Blender 内部运行一个 socket 服务,用来接收来自 MCP 服务端的指令。

### 下载插件[](https://blendermcp.org/zh-cn/setup/vscode#%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/vscode#%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/vscode#%E5%90%AF%E7%94%A8%E6%8F%92%E4%BB%B6)

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

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

### 打开 BlenderMCP 面板[](https://blendermcp.org/zh-cn/setup/vscode#%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/vscode#%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/vscode#%E7%82%B9%E5%87%BB-connect-to-claude)

这一步会启动 Blender 内部的 socket 服务。(按钮上写的是 Claude,但它对所有 MCP 客户端都有效,包括 Cline 和 Roo Code。)你应该会看到一条确认连接成功的状态提示。

### 在 VSCode 中打开 AI 对话[](https://blendermcp.org/zh-cn/setup/vscode#%E5%9C%A8-vscode-%E4%B8%AD%E6%89%93%E5%BC%80-ai-%E5%AF%B9%E8%AF%9D)

在 VSCode 里打开 Cline 或 Roo Code 的对话面板,你应该能看到 Blender MCP 的工具已经可用。试试这些提示词:

-   _“做一个悬在蓝色立方体上方的红色金属球”_
-   _“做一个低多边形的地牢场景,里面有一条守着一罐金币的龙”_
-   _“布置影棚灯光,并把相机对准场景,用等距视角”_

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

## 排错[](https://blendermcp.org/zh-cn/setup/vscode#%E6%8E%92%E9%94%99)

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

-   确认 Blender 插件那边的服务已经在运行(看 BlenderMCP 侧栏面板)
-   改完 MCP 配置后重启 VSCode
-   确认 uv 已安装:`uv --version`
-   **不要**自己在终端里手动运行 `uvx blender-mcp` —— MCP 服务端由扩展来管理

### 对话里看不到 MCP 工具[](https://blendermcp.org/zh-cn/setup/vscode#%E5%AF%B9%E8%AF%9D%E9%87%8C%E7%9C%8B%E4%B8%8D%E5%88%B0-mcp-%E5%B7%A5%E5%85%B7)

-   确认 Cline 或 Roo Code 已安装并启用
-   检查 MCP 配置是否已保存,以及 VSCode 是否重新加载过
-   在 Windows 上,确认 uv 的 bin 目录已经在 PATH 里

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

连接之后的第一条指令有时会失败。再发一条,之后通常就正常了。

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

-   把复杂场景拆成几个小的、按顺序执行的提示词
-   不要在一次请求里做特别大或特别重的操作

想更深入了解服务端的工作方式,可以看我们的 [MCP 服务端架构详解](https://blendermcp.org/zh-cn/server)。

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

[

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

### Blender MCP 配置演示

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

用的是别的 AI 客户端?

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

## 常见问题

### VSCode 原生支持 Blender MCP 吗?

不支持。VSCode 没有内置的 MCP 支持,你需要一个兼容 MCP 的扩展,比如 Cline 或 Roo Code。它们会加上一个 AI 对话面板,并支持连接 Blender MCP 这类 MCP 服务端。

### 在 VSCode 里,Blender 的 MCP 配置怎么写?

和 Claude Desktop 的写法一样:{"mcpServers":{"blender":{"command":"uvx","args":\["blender-mcp"\]}}}。把它加到 Cline 或 Roo Code 的 MCP 设置里。

### 配合 Blender MCP,Cline 和 Roo Code 选哪个?

两个都支持 MCP,也都能配合 Blender MCP,配置完全相同。按你更喜欢哪个扩展的界面和功能来选就行。

### 不装 Cline 或 Roo Code,能在 VSCode 里用 Blender MCP 吗?

不能。没有 MCP 客户端扩展,VSCode 无法连接 MCP 服务端。Cursor 原生支持 MCP;如果你更喜欢那种方式,可以看我们的 Cursor 配置指南。

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