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

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

完整教程

加入社区

提供反馈，获取灵感，并在此基础上构建：Discord

支持者

主要支持者:

CodeRabbit

所有支持者:

支持此项目

发布说明 (1.1.0)

• 通过 Poly Haven API 增加了对 Poly Haven 资源的支持
• 通过 Hyper3D Rodin 增加了提示3D模型的支持
• 对于新用户，可以直接跳到安装部分。对于现有用户，请参阅以下几点
• 下载最新的 addon.py 文件替换旧文件，然后添加到 Blender 中
• 从 Claude 中删除 MCP 服务器并重新添加，这样应该就可以正常工作了！

功能

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

组件

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

1. Blender 插件 (addon.py)：一个 Blender 插件，在 Blender 内部创建一个套接字服务器以接收和执行命令
2. MCP 服务器 (src/blender_mcp/server.py)：一个实现模型上下文协议并连接到 Blender 插件的 Python 服务器

安装

先决条件

• 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"
            ]
        }
    }
}

光标集成

通过 uvx 运行 blender-mcp 而不永久安装它。转到光标设置 > MCP 并粘贴此命令。

uvx blender-mcp

光标设置视频

⚠️ 仅运行一个 MCP 服务器实例（要么在光标上，要么在 Claude 桌面上），不要同时运行两者

安装 Blender 插件

1. 从此仓库下载 addon.py 文件
2. 打开 Blender
3. 转到编辑 > 首选项 > 插件
4. 点击“安装...”并选择 addon.py 文件
5. 通过选中“界面: Blender MCP”旁边的复选框启用插件

使用

启动连接

1. 在 Blender 中，转到 3D 视图侧边栏（如果不可见，请按 N 键）
2. 找到 "BlenderMCP" 标签
3. 如果你希望从他们的 API 获取资源，请勾选 Poly Haven 复选框（可选）
4. 点击 "连接到 Claude"
5. 确保 MCP 服务器在你的终端中运行

与 Claude 一起使用

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

功能

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

示例命令

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

• "在一个地牢中创建一个低多边形场景，其中有一条龙守护着一锅金子" 演示
• "使用 HDRIs、纹理以及来自 Poly Haven 的岩石和植被等模型来创建海滩氛围" 演示
• 提供参考图片，并根据它创建一个 Blender 场景 演示
• "通过 Hyper3D 生成一个花园侏儒的 3D 模型"
• "获取当前场景的信息，并从中制作一个 threejs 草图" 演示
• "让这辆车变成红色并且具有金属质感"
• "创建一个球体并将其放置在立方体上方"
• "使照明像工作室一样"
• "将相机对准场景，并使其呈现等距视角"

Hyper3D 集成

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

故障排除

• 连接问题：确保 Blender 插件服务器正在运行，并且已在 Claude 上配置了 MCP 服务器，不要在终端中运行 uvx 命令。有时第一个命令无法通过，但之后会开始正常工作。
• 超时错误：尝试简化你的请求或将它们分解为更小的步骤
• Poly Haven 集成：Claude 有时行为不稳定
• 是否尝试过重启？：如果你仍然遇到连接错误，尝试重新启动 Claude 和 Blender 服务器

技术细节

通信协议

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

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

限制与安全注意事项

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

贡献

欢迎贡献！请随时提交Pull Request。

免责声明

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