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 安装为
在 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 工具的锤子图标。
功能
示例命令
以下是您可以要求克劳德做的事情的一些示例：
- “创建一个地牢中的低多边形场景，其中一条龙守护着一罐金子”演示
- “使用 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制作