local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. Enables prompt assisted 3D modeling, scene creation, and manipulation.

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

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

完整教程

加入社区

提供反馈、获得启发并在 MCP 的基础上构建： Discord

支持者

主要支持者：

代码兔

全体支持者：

支持这个项目

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

光标集成

对于 Mac 用户，请转至“设置”>“MCP”并粘贴以下内容

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

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

对于 Windows 用户，请转到“设置”>“MCP”>“添加服务器”，使用以下设置添加新服务器：

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

光标设置视频

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

安装Blender插件

从这个 repo 下载addon.py文件
打开 Blender
前往“编辑”>“首选项”>“附加组件”
点击“安装...”并选择addon.py文件
选中“接口：Blender MCP”旁边的框来启用该插件

用法

启动连接

在 Blender 中，转到 3D 视图侧栏（如果看不到，请按 N）
找到“BlenderMCP”选项卡
如果您需要来自其 API 的资产，请选中 Poly Haven 复选框（可选）
点击“连接到 Claude”
确保 MCP 服务器正在你的终端中运行

与 Claude 一起使用

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

功能

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

示例命令

以下是您可以要求克劳德做的事情的一些示例：

“创建一个地牢中的低多边形场景，其中一条龙守护着一罐金子”演示
“使用 HDRI、纹理以及 Poly Haven 的岩石和植被等模型营造海滩氛围”演示
提供参考图像，并根据它创建一个 Blender 场景演示
“通过 Hyper3D 生成花园侏儒的 3D 模型”
“获取当前场景的信息，并根据该信息制作 ThreeJS 草图”演示
“让这辆车变成红色和金属色”
“创建一个球体并将其放置在立方体上方”
“让灯光像工作室一样”
“将相机对准场景，并使其等距”

Hyper3D 集成

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

故障排除

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

技术细节

通信协议

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

命令以 JSON 对象的形式发送，带有type和可选params
响应是带有status和result或message JSON 对象

限制和安全注意事项

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

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

免责声明

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

通过模型上下文协议 (MCP) 将 Blender 连接到 Claude AI，使 Claude 能够直接与 Blender 交互并控制 Blender 进行 AI 辅助 3D 建模、场景操作和渲染。

Related Resources

Reddit Discussion about this server