MCP

MCP for Blender

把 AI 连接到 Blender,协助查看场景、创建物体以及调整材质。

适用对象:Blender。原作者资料整理。

把 Blender 连接到 Cursor

按来源文档整理的具体步骤,本站尚未在此配对环境实机运行。

适用系统:macos。教程整理:2026-11-09。

准备条件

  • macOS 上已安装 Blender 3.0+、Python 3.10+、uv 和 Cursor。
  • 先用一个空白或副本场景;首次任务只读取物体。
  • 此社区插件可执行 Blender Python;本次不需要启用额外的付费素材或生成服务。

接入步骤

  1. 在终端确认 uvx 可用;若尚未安装 uv,按其官方安装文档完成后再继续。
  2. 按原作者方式把插件安装到 Blender;打开 Blender → Edit → Preferences → Add-ons,启用 MCP for Blender。
  3. 在项目根目录的 .cursor/mcp.json 添加下方 blender 项;已有其他 MCP 时合并配置,保留其他条目。
  4. 在 Blender 的三维视图按 N 打开侧栏,找到 MCP for Blender,启动连接。按钮文案可能仍写 Connect to Claude;它启动的是插件连接。
  5. 完全退出并重新打开 Cursor,查看 MCP 工具是否加载;同一端口只运行一个对应服务器。

检查 uvx 是否可用

uvx --version

按作者方式安装 Blender 插件

uvx mcp-for-blender install-addon

Cursor 项目配置 · .cursor/mcp.json

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

第一次小任务

请只读取当前 Blender 场景中的物体列表,说明名称和类型,不创建、修改或删除任何物体。

怎样核对结果

  • Cursor 中能看到 Blender 相关工具或连接状态。
  • 返回的物体名称能与当前 Blender 场景对照。
  • 场景中的原有物体没有被修改。

遇到问题

uvx 在终端可用,Cursor 却提示找不到

用 which uvx 找到完整路径,替换配置里的 command,再完全退出并重开 Cursor。

连接失败或端口被占用

确认 Blender 插件连接已启动,停止同端口的重复 MCP 实例;主机和端口需与作者设置一致。

Python 依赖安装失败

查看原作者 Pin the Python version 小节,核对其 Python 版本固定方式,不反复安装不明包。

如何停用

  • 在 Cursor 关闭该 MCP,或只移除 .cursor/mcp.json 中的 blender 项并重启。
  • 在 Blender 插件面板停止连接;需要停用时在 Add-ons 中关闭该插件。