Skip to Content
安装指南VSCode

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

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

前置条件

开始之前:

  • Blender 3.0 或更新的版本 —— 从 blender.org 下载 。推荐 Blender 4.x。
  • Python 3.10 或更新的版本 —— 一般系统自带。用 python3 --version 检查。
  • Visual Studio Code —— 从 code.visualstudio.com 下载 。
  • Cline 或 Roo Code —— 支持 MCP 的扩展,在 VSCode 扩展市场里安装。

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

第 1 步:安装 uv 包管理器

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

brew install uv

验证安装:

uv --version

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

第 2 步:在 VSCode 中安装 Cline 或 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 服务端

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

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

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

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

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

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

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

第 4 步:安装 Blender 插件

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

下载插件

从 Blender MCP 的 GitHub 仓库 下载 addon.py。

在 Blender 中安装

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

启用插件

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

第 5 步:连接并做出第一个 3D 模型

打开 BlenderMCP 面板

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

启用 Poly Haven(可选)

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

点击 “Connect to Claude”

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

在 VSCode 中打开 AI 对话

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

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

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

排错

”Connection refused” 或 “MCP server not found”

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

对话里看不到 MCP 工具

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

第一条指令没反应

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

超时错误

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

想更深入了解服务端的工作方式,可以看我们的 MCP 服务端架构详解。

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

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

Blender MCP 配置演示

用的是别的 AI 客户端?

Claude 配置 →Cursor 配置 →ChatGPT 配置 →Gemini 配置 →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 →

最后更新于
CursorChatGPT