Blender MCP · 安装

Installing Blender MCP

Blender MCP 是一个运行在您计算机上的服务器，由您的 MCP 客户端（Claude Desktop, Cursor, Claude Code, Codex）启动。您可以使用 Synthetic Setup 进行安装。它通过 Synthetic Blender MCP 插件与 Blender 通信，您只需在 Blender 中启用一次该插件即可。已在 Windows 上验证。

要求

Blender	5.1 或 5.2 LTS
Node.js	18 或更高版本
OS	Windows 10/11 · macOS（测试版：可能存在错误）
MCP 客户端	Claude Desktop, Cursor, Codex 或任何 MCP 客户端
许可证	您的 Blender MCP 许可证密钥（请参阅 /dashboard/licenses）

1. Install it with Synthetic Setup

Download Synthetic Setup from /dashboard/downloads and run it. It finds your MCP clients (Claude Desktop, Cursor, Claude Code, Codex) and adds Blender MCP to each one with your license already loaded.

Prefer to edit your client's config by hand? The MCP client setup guide shows the exact entry.

2. Restart your MCP client

退出您的 MCP 客户端并重新打开：服务器在启动时加载。首次运行时，服务器将在几秒钟内下载，并在验证您的许可证后，将 Blender 插件保存在您计算机的 C:\Users\YOUR_USER\.synthetic\mcp\blender-mcp\<version>\blender-addon\ 中。

Synthetic Setup 还会处理 Node.js：如果您的计算机尚未安装，它将为您的 MCP 客户端安装该环境。

3. 在 Blender 中启用插件

每个 Blender 版本仅需执行一次：

在 Blender 中，打开编辑 → 偏好设置 → 插件。
打开列表右上角的菜单，选择从磁盘安装… 并从步骤 2 的文件夹中选择文件 synthetic_blender_mcp.py。
检查列表中 “Synthetic Blender MCP” 是否已启用。

该插件在每次启动 Blender 时会自动运行。其状态显示在 3D 视图侧边栏（按 N 键）→ Synthetic MCP 选项卡中。

根据 Blender 对插件的要求，该插件是基于 GNU GPL 第 3 版的自由软件；而 MCP 服务器是 Synthetic 的自有软件，需要您的许可证。

4. Try it

With Blender open, ask your MCP client something simple:

What version of Blender is open, and what objects are in the scene?

If it answers with your Blender version and your objects, everything works. Then try something bigger: build a small scene, light it and render it.

Important: Blender must be open, with the add-on enabled, whenever your MCP client runs a tool. Otherwise the tools answer that Blender is not connected.

← Blender MCP 客户端设置