内容
# BlenderMCP - Blender 模型上下文协议集成
BlenderMCP 通过模型上下文协议（MCP）将 Blender 连接到 Claude AI，允许 Claude 直接与 Blender 交互并控制它。此集成实现了提示辅助的 3D 建模、场景创建和操作。
[完整教程](https://www.youtube.com/watch?v=lCyQ717DuzQ)
### 加入社区
提供反馈、获取灵感并在此基础上构建：[Discord](https://discord.gg/z5apgR8TFU)
### 支持者
<div align="center" markdown="1">
<sup>特别感谢：</sup>
<br>
<br>
<a href="https://www.warp.dev/blender-mcp">
<img alt="Warp sponsorship" width="400" src="https://github.com/user-attachments/assets/c21102f7-bab9-4344-a731-0cf6b341cab2">
</a>
### [Warp：开发者的智能终端](https://www.warp.dev/blender-mcp)
[适用于 MacOS、Linux 和 Windows](https://www.warp.dev/blender-mcp)<br>
</div>
<hr>
**其他支持者：**
[CodeRabbit](https://www.coderabbit.ai/)
**所有支持者：**
[支持该项目](https://github.com/sponsors/ahujasid)
## 发布说明（1.2.0）
- 查看 Blender 视口的截图以更好地理解场景
- 搜索和下载 Sketchfab 模型
### 以前添加的功能：
- 通过 Poly Haven API 支持 Poly Haven 资产
- 支持使用 Hyper3D Rodin 生成 3D 模型
- 对于新用户，您可以直接进入安装。对于现有用户，请查看以下几点
- 下载最新的 addon.py 文件并替换旧文件，然后将其添加到 Blender
- 从 Claude 删除 MCP 服务器并重新添加，您应该就可以了！
## 功能
- **双向通信**：通过基于套接字的服务器将 Claude AI 连接到 Blender
- **对象操作**：在 Blender 中创建、修改和删除 3D 对象
- **材质控制**：应用和修改材质和颜色
- **场景检查**：获取当前 Blender 场景的详细信息
- **代码执行**：在 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**
```bash
brew install uv
```
**在 Windows 上**
```bash
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
```
然后
```bash
set Path=C:\Users\nntra\.local\bin;%Path%
```
否则，请在他们的网站上查看安装说明：[安装 uv](https://docs.astral.sh/uv/getting-started/installation/)
**⚠️ 安装 UV 之前请勿继续**
### Claude 桌面集成
[观看设置说明视频](https://www.youtube.com/watch?v=neoK_WMq92g) （假设您已经安装了 uv）
转到 Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json 包括以下内容：
```json
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": [
"blender-mcp"
]
}
}
}
```
### 光标集成
[](https://cursor.com/install-mcp?name=blender&config=eyJjb21tYW5kIjoidXZ4IGJsZW5kZXItbWNwIn0%3D)
对于 Mac 用户，转到设置 > MCP 并粘贴以下内容
- 要用作全局服务器，请使用“添加新全局 MCP 服务器”按钮并粘贴
- 要用作项目特定服务器，请在项目的根目录中创建 `.cursor/mcp.json` 并粘贴
```json
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": [
"blender-mcp"
]
}
}
}
```
对于 Windows 用户，转到设置 > MCP > 添加服务器，添加一个具有以下设置的新服务器：
```json
{
"mcpServers": {
"blender": {
"command": "cmd",
"args": [
"/c",
"uvx",
"blender-mcp"
]
}
}
}
```
[光标设置视频](https://www.youtube.com/watch?v=wgWsJshecac)
**⚠️ 仅运行一个 MCP 服务器实例（在光标或 Claude 桌面上），不要同时运行两个**
### 安装 Blender 插件
1. 从此仓库下载 `addon.py` 文件
1. 打开 Blender
2. 转到 编辑 > 首选项 > 插件
3. 点击“安装...”并选择 `addon.py` 文件
4. 通过选中“接口：Blender MCP”旁边的复选框来启用插件
## 用法
### 启动连接
1. 在 Blender 中，转到 3D 视图侧边栏（按 N 如果不可见）
2. 找到“BlenderMCP”选项卡
3. 如果您想从 Poly Haven API 获取资产，请启用 Poly Haven 复选框（可选）
4. 点击“连接到 Claude”
5. 确保 MCP 服务器在您的终端中运行
### 与 Claude 一起使用
一旦在 Claude 上设置了配置文件，并且 Blender 上的插件正在运行，您将看到带有 Blender MCP 工具的锤子图标。
#### 功能
- 获取场景和对象信息
- 创建、删除和修改形状
- 为对象应用或创建材质
- 在 Blender 中执行任意 Python 代码
- 通过 [Poly Haven](https://polyhaven.com/) 下载正确的模型、资产和 HDRIs
- 通过 [Hyper3D Rodin](https://hyper3d.ai/) 生成 3D 模型
### 示例命令
以下是您可以要求 Claude 执行的一些示例：
- “在一个地牢中创建一个低多边形场景， guarded by a dragon 守卫着一个金币盆” [演示](https://www.youtube.com/watch?v=DqgKuLYUv00)
- “使用 HDRIs、纹理和 Poly Haven 中的岩石和植被等模型创建一个海滩氛围” [演示](https://www.youtube.com/watch?v=I29rn92gkC4)
- 提供参考图像，并从中创建一个 Blender 场景 [演示](https://www.youtube.com/watch?v=FDRb03XPiRo)
- “使用 Hyper3D 生成一个花园侏儒的 3D 模型”
- “获取当前场景的信息，并从中创建一个 threejs 草图” [演示](https://www.youtube.com/watch?v=jxbNI5L7AH8)
- “使这辆车红色且金属化”
- “创建一个球体并将其放在立方体上方”
- “使照明像工作室一样”
- “将相机指向场景，使其等距”
## 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](https://x.com/sidahuj) 制作
