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

BlenderMCP 通过模型上下文协议（MCP）将 Blender 与 Claude AI 连接起来，使 Claude 能够直接与 Blender 进行交互和控制。该集成实现了提示辅助的 3D 建模、场景创建和操作。

我们没有官方网站。你在网上看到的任何网站都是非官方的，与此项目无关。使用它们需自担风险。

完整教程

加入社区

提供反馈、获取灵感并在 MCP 基础上进行构建：Discord

支持者

^{特别感谢：}

Warp，开发者的智能终端

适用于 MacOS、Linux 和 Windows

其他支持者：

CodeRabbit

Satish Goda

所有支持者：

支持此项目

发布说明 (1.2.0)

查看 Blender 视口的截图以更好地理解场景
搜索并下载 Sketchfab 模型

之前添加的功能：

通过 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)：一个实现模型上下文协议并连接到 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 之前不要继续

环境变量

以下环境变量可用于配置 Blender 连接：

BLENDER_HOST：Blender 套接字服务器的主机地址（默认："localhost"）
BLENDER_PORT：Blender 套接字服务器的端口号（默认：9876）

示例：

export BLENDER_HOST='host.docker.internal'
export BLENDER_PORT=9876

Claude for Desktop 集成

观看设置说明视频（假设你已经安装了 uv）

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

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

Cursor 集成

安装 MCP 服务器

对于 Mac 用户，前往设置 > MCP 并粘贴以下内容

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

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

对于 Windows 用户，前往设置 > MCP > 添加服务器，添加一个新服务器，设置如下：

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

Cursor 设置视频

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

Visual Studio Code 集成

先决条件：在继续之前，请确保你已经安装了 Visual Studio Code。

安装 Blender 插件

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

使用

启动连接

侧边栏中的 BlenderMCP

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

与 Claude 一起使用

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

侧边栏中的 BlenderMCP

功能

获取场景和对象信息
创建、删除和修改形状
应用或创建对象的材质
在 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 服务器

技术细节

通信协议

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

命令作为带有 type 和可选 params 的 JSON 对象发送
响应作为带有 status 和 result 或 message 的 JSON 对象返回

限制和安全考虑

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

贡献

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

免责声明

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