BlenderMCP - Blender模型上下文协议集成

BlenderMCP 通过模型上下文协议 (MCP) 将 Blender 连接到 Claude AI，允许 Claude 直接交互并控制 Blender。此集成支持提示辅助的3D建模、场景创建和操作。

完整教程

加入社区

提供反馈，获得灵感，并基于 MCP 进行构建：Discord

支持者

主要支持者：

CodeRabbit

所有支持者：

支持此项目

版本说明 (1.1.0)

添加了通过其 API 支持 Poly Haven 资源
添加了使用 Hyper3D Rodin 提示 3D 模型的支持
对于新手，您可以直接跳到安装部分。对于现有用户，请参见以下几点
下载最新的 addon.py 文件并替换旧文件，然后将其添加到 Blender
从 Claude 中删除 MCP 服务器，然后重新添加，一切就绪！

功能

双向通信: 通过基于套接字的服务器将 Claude AI 连接到 Blender
对象操作: 在 Blender 中创建、修改和删除 3D 对象
材质控制: 应用和修改材质和颜色
场景检查: 获取有关当前 Blender 场景的详细信息
代码执行: 从 Claude 在 Blender 中运行任意 Python 代码

组件

系统由两个主要组件组成：

Blender 插件 (addon.py): 一个Blender插件，在Blender中创建一个套接字服务器以接收和执行命令
MCP服务器 (src/blender_mcp/server.py): 一个Python服务器，它实现了模型上下文协议（Model Context Protocol）并连接到Blender插件

安装

前提条件

Blender 3.0 或更高版本
Python 3.10 或更高版本
uv 包管理器：

如果您使用Mac，请安装uv：

brew install uv

在Windows上

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

然后

set Path=C:\Users\nntra\.local\bin;%Path%

否则，安装说明在其网站上：安装 uv

⚠️ 在安装UV之前，请勿继续

Claude 桌面集成

观看设置说明视频（假设您已安装uv）

进入 Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json 并包含以下内容：

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

游标集成

对于Mac用户，请进入设置 > MCP 并粘贴以下内容：

要用作全局服务器，请使用“添加新的全局MCP服务器”按钮并粘贴
要用作项目特定服务器，请在项目的根目录中创建.cursor/mcp.json文件并粘贴

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

对于Windows用户，请进入设置 > MCP > 添加服务器，并使用以下设置添加一个新服务器：

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

光标设置视频

⚠️ 仅运行一个 MCP 服务器实例（在 Cursor 或 Claude Desktop 上），不要同时运行两个

安装 Blender 插件

从此仓库下载 addon.py 文件
打开 Blender
前往编辑 > 首选项 > 插件
点击“安装...”并选择 addon.py 文件
选中“界面：Blender MCP”旁边的框以启用插件

使用方法

启动连接

BlenderMCP 侧边栏

在 Blender 中，前往 3D 视图侧边栏（如果不可见，按 N 键）
找到“BlenderMCP”选项卡
如果你想使用其 API 中的资源，则启用 Poly Haven 复选框（可选）
点击“连接到 Claude”
确保 MCP 服务器正在你的终端运行

与 Claude 配合使用

在 Claude 上设置配置文件并在 Blender 上运行插件后，你将看到一个带有 Blender MCP 工具的锤子图标。

功能

获取场景和对象信息
创建、删除和修改形状
为对象应用或创建材质
在 Blender 中执行任何 Python 代码
通过 Poly Haven 下载合适的模型、资源和 HDRI
通过 Hyper3D Rodin 生成 AI 模型

示例命令

以下是一些你可以要求 Claude 执行的操作示例：

“在一个地牢中创建一个低多边形场景，一个龙守护着一罐金子” 演示
“使用 HDRI、纹理和来自 Poly Haven 的岩石和植被等模型来创建一个海滩氛围” 演示
给出一张参考图片，并根据它创建一个 Blender 场景演示
“通过 Hyper3D 生成一个花园侏儒的 3D 模型”
“获取有关当前场景的信息，并从中制作一个 three.js 草图” 演示
“把这辆车涂成红色金属漆”
“创建一个球体并将其放置在立方体上方”
“将灯光设置为工作室灯光”
“将摄像机对准场景，并使其为等轴测视角”

Hyper3D 集成

Hyper3D 的免费试用密钥每天允许生成有限数量的模型。如果达到每日限制，您可以等待第二天重置，或从 hyper3d.ai 和 fal.ai 获取您自己的密钥。

故障排除

连接问题: 确保Blender插件服务器正在运行，并且MCP服务器已在Claude上配置，请勿在终端运行uvx命令。有时，第一个命令不会执行，但之后它会开始工作。
超时错误: 请尝试简化您的请求或将其分解成更小的步骤。
Poly Haven集成: Claude 的行为有时不稳定。
你试过关掉再打开吗？: 如果您仍然遇到连接错误，请尝试重新启动 Claude 和 Blender 服务器。

技术细节

通信协议

系统使用基于 JSON 的简单协议通过 TCP 套接字：

命令以包含 type 和可选 params 的 JSON 对象发送。
响应是包含 status 和 result 或 message 的 JSON 对象。

限制与安全注意事项

execute_blender_code 工具允许在 Blender 中运行任意的 Python 代码，这功能强大但也可能很危险。在生产环境中使用时务必谨慎。使用前务必保存您的工作。
Poly Haven 需要下载模型、纹理和 HDRI 图片。如果您不想使用它，请在 Blender 的复选框中将其关闭。
复杂的运算可能需要分解成更小的步骤。

贡献

欢迎贡献！请随时提交拉取请求。

免责声明

这是一个第三方集成，并非Blender官方出品。由Siddharth制作