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

BlenderMCP 通过模型上下文协议 (MCP) 将 Blender 连接到 Claude AI，使 Claude 能够直接与 Blender 交互和控制 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 代码

组件

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

1. Blender 插件 (addon.py)：一个 Blender 插件，在 Blender 中创建一个套接字服务器以接收和执行命令
2. MCP 服务器 (src/blender_mcp/server.py)：一个 Python 服务器，实现模型上下文协议并连接到 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"
            ]
        }
    }
}

Cursor 集成

通过 uvx 运行 blender-mcp，而无需永久安装它。转到 Cursor 设置 > MCP 并将此粘贴为命令。

uvx blender-mcp

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

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

Cursor 设置视频

⚠️ 仅运行一个 MCP 服务器实例（在 Cursor 或 Claude Desktop 上），而不是两者都运行

安装 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 插件服务器正在运行，并且 MCP 服务器已在 Claude 上配置，不要在终端中运行 uvx 命令。有时，第一个命令不会通过，但之后它会开始工作。
• 超时错误：尝试简化您的请求或将其分解为更小的步骤
• Poly Haven 集成：Claude 有时行为不稳定
• 您是否尝试过重新启动？：如果您仍然遇到连接错误，请尝试重新启动 Claude 和 Blender 服务器

技术细节

通信协议

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

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

限制和安全注意事项

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

贡献

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

免责声明

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