Skip to Content
安装指南Cursor

如何在 Cursor 中配置 Blender MCP(2026 版指南)

可以,Cursor 支持 MCP。 Cursor 原生支持 MCP 服务端,是用 AI 做 Blender 3D 建模最顺手的 IDE 之一。本指南从安装依赖到做出第一个 3D 模型,完整走一遍。

借助 Cursor 的 MCP 集成,你可以把 Blender MCP 配成全局服务端(所有项目都能用),也可以配成只属于某个项目的服务端。整个配置大约 5 分钟。

前置条件

第 1 步:安装 uv 包管理器

brew install uv

第 2 步:在 Cursor 中添加 MCP 服务端

有两种做法——全局服务端,或只属于某个项目的服务端。

方案 A:全局 MCP 服务端(推荐)

进入 Cursor Settings → MCP,点击 “Add new global MCP server”,粘贴这段配置:

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

方案 B:只属于某个项目的服务端

在项目根目录下创建一个 .cursor/mcp.json 文件:

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

Windows 用户注意: 配置里多了 cmd + /c 这一层包装。这是必需的,因为 Windows 处理 uvx 的方式和 macOS / Linux 不一样。

第 3 步:安装 Blender 插件

下载 addon.py

从 Blender MCP 的 GitHub 仓库 获取最新的 addon.py。

在 Blender 中安装

打开 Blender → Edit → Preferences → Add-ons → “Install…” → 选择 addon.py。

启用它

勾选 “Interface: Blender MCP” 前面的复选框。

第 4 步:连接并开始使用

启动 Blender 一侧的服务

在 Blender 的 3D 视图里按 N 打开侧栏 → 找到 “BlenderMCP” 标签页 → 点击 “Connect to Claude”(这个按钮对所有客户端都有效,不只是 Claude)。

打开 Cursor 的 Agent

在 Cursor 里打开 AI 对话(Agent 模式),你应该能看到 Blender MCP 的工具已经可用。

发出第一条提示词

试试:“在 Blender 里做一个悬在蓝色立方体上方的红色金属球”

同一时间只运行一个 MCP 服务端实例。 如果你在 Claude Desktop 里也配了 Blender MCP,请先把那边断开。两个同时跑会造成连接冲突。

怎么确认 Cursor 里的 MCP 状态

要确认 MCP 服务端已经连上:

  1. 进入 Cursor Settings → MCP —— 应该能看到 “blender” 在列表里,状态是绿色的
  2. 在 Agent 对话中,MCP 工具会出现在工具列表里
  3. 如果状态显示为红色/未连接,试着重启 Cursor

MCP 让 Cursor 多了什么能力?

连上 Blender MCP 之后,Cursor 的 AI agent 可以:

  • 创建和修改 3D 物体 —— 网格、材质、灯光
  • 查看你的 Blender 场景 —— 获取物体列表、材质数据和场景结构
  • 下载素材 —— Poly Haven 的 HDRI / 贴图 / 模型,以及 Sketchfab 的模型
  • 生成 3D 模型 —— 通过 Hyper3D Rodin 和 Hunyuan3D
  • 执行 Python 代码 —— 运行任意 Blender Python 脚本
  • 截取视图画面 —— 让 AI 看到你当前的场景

这和用 Cursor 写代码不是一回事——MCP 工具让 Cursor 直接接触到 Blender 的 3D 环境。

排错

设置里 MCP 服务端显示红色/未连接

  • 确认 uv 已安装:uv --version
  • 在 Windows 上,确认配置用了 cmd + /c 这层包装
  • 添加配置后重启 Cursor
  • 检查是不是已经有别的 MCP 客户端(比如 Claude Desktop)连着

连不上 Blender

  • 确认 BlenderMCP 插件已启用,并且点过 “Connect” 按钮
  • 检查 9876 端口有没有被防火墙拦住
  • 试着重启 Blender 再连一次

第一条指令超时

已知的小毛病——第一条指令有时会失败。再发一条,通常就正常了。

大场景下的性能

场景复杂时,把请求拆成小步骤。Cursor 对连续的工具调用处理得不错,所以分成多步的提示词往往比一条复杂的更可靠。

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

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

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

Blender MCP 配置演示

用的是别的 AI 客户端?

Claude 配置 →VSCode 配置 →ChatGPT 配置 →Gemini 配置 →Ollama 配置 →

常见问题

Cursor 可以用 MCP 吗?

可以。Cursor 原生支持 MCP。进入 Settings → MCP 就能添加 MCP 服务端。Blender MCP 既可以配成全局服务端(所有项目可用),也可以通过 .cursor/mcp.json 配成只属于某个项目的服务端。

怎么在 Cursor 里查看 MCP?

进入 Cursor Settings → MCP,可以看到所有已配置的 MCP 服务端及其连接状态。绿色表示已连接。你也可以在 Agent 对话的工具列表里看到可用的 MCP 工具。

MCP 让 Cursor 多了什么能力?

MCP 让 Cursor 的 AI agent 能够调用外部工具。接上 Blender MCP 之后,Cursor 可以创建 3D 物体、设置材质、布置灯光、从 Poly Haven 下载素材、用 AI 生成模型、在 Blender 中执行 Python 代码,以及截取视图画面。

在 Cursor 上用 Blender MCP 要花钱吗?

不用。Blender MCP 免费且开源。Cursor 本身也有包含 AI 功能的免费版本。整套配置本身不产生费用。

配置还是不顺利?这正是开源那条路的代价 —— AI 客户端、模型和配置都要你自己选、自己维护。我们自己的付费应用 3D-Agent 则把 AI 和整套工具一并包含在内。 对比 Blender MCP 与 3D-Agent →

最后更新于
ClaudeVSCode