内容
<!--
Blender MCP 服务器
连接 AI 助手到 Blender 进行 3D 创建
-->
<h1 align="center">
<br>
<img src="https://raw.githubusercontent.com/IamNishant51/Blender-MCP/main/logo.png" alt="Blender MCP" width="120">
<br>
<br>
Blender MCP 服务器
<br>
</h1>
<p align="center">
<strong>用于通过 AI 助手控制 Blender 的 MCP 服务器</strong>
<br>
Claude 代码 | OpenCode | GitHub Copilot
</p>
---
## 概述
Blender MCP 使 AI 助手能够以编程方式控制 Blender，允许您：
- 创建具有详细规划和程序生成的复杂 3D 模型
- 在互联网上搜索 3D 模型和纹理
- 将材质和纹理应用于对象
- 修改现有模型
- 导入和导出 3D 文件
---
## 安装
```bash
# 从 npm 安装
npm install -g blender-mcp
# 或使用 npx
npx blender-mcp
```
**要求：** Node.js 18+ 和 Blender 已安装
---
## 可用工具
| 工具 | 描述 |
|------|-------------|
| `create_complex_model` | 使用互联网搜索和详细规划构建复杂的 3D 模型。支持印度主题：寺庙、车辆、食物、角色、建筑物等。 |
| `modify_model` | 修改现有的 3D 模型 - 更改颜色、材质、比例、旋转或应用效果。 |
| `apply_texture` | 将程序材质应用于 3D 对象（木材、大理石、石头、金属等）。 |
| `search_models` | 在多个来源中搜索整个互联网的 3D 模型。 |
| `search_textures` | 从在线数据库搜索免费纹理。 |
| `get_scene_info` | 获取当前 Blender 场景的信息。 |
| `import_from_url` | 直接从 URL 导入 3D 模型。 |
---
## 配置
### Claude 代码
添加到您的 `~/.claude.json`：
```json
{
"mcpServers": {
"blender": {
"command": "npx",
"args": ["blender-mcp"]
}
}
}
```
### OpenCode
```json
{
"blender": "npx blender-mcp"
}
```
### 其他 MCP 客户端
```bash
npx blender-mcp
# 或
npm install -g blender-mcp && blender-mcp
```
---
## 内置模型模板
服务器包括各种印度主题 3D 模型的程序生成：
| 类别 | 描述 |
|----------|-------------|
| **寺庙** | 详细的印度寺庙，带有柱子、曼陀婆、悉多罗、托拉那和装饰元素 |
| **车辆** | 自动人力车（Tuk-Tuk），带有轮子、驾驶室、前灯和细节 |
| **食物** | 传统的印度塔利，带有盘子、米饭、咖喱、罗提和配菜 |
| **建筑物** | 哈维利/宫殿结构，带有多个楼层、贾利窗户、查特里斯和庭院 |
| **角色** | 穿着传统印度服装（长衫）的人物 |
### 材质库
内置程序材质：
| 材质 | 变体 |
|----------|----------|
| 大理石 | 白色、红色、绿色 |
| 金属 | 金色、铜色、铜合金 |
| 石头 | 石头、砂岩、陶土 |
| 木材 | 标准木纹 |
---
## 环境变量
| 变量 | 默认值 | 描述 |
|----------|---------|-------------|
| `BLENDER_EXECUTABLE` | `blender` | Blender 可执行文件路径 |
| `BLENDER_TIMEOUT` | `120` | Blender 操作超时（秒） |
| `BLENDER_MCP_DIR` | `~/Desktop/BLENDER-MCP` | 输出文件基准目录 |
| `BLENDER_MCP_DEBUG` | `false` | 启用调试日志 |
---
## 示例用法
连接到 AI 助手后，您可以创建 3D 场景，例如：
1. "创建一个带有红色大理石材质的印度寺庙"
2. "用黄色建造一个传统的自动人力车"
3. "创建一个带有米饭和多种咖喱的塔利"
4. "为我的模型添加大理石纹理"
5. "搜索免费的椅子 3D 模型"
---
## 架构
```
+-----------+ MCP +-------------+ 子进程 +---------+
| Claude/ | <----------> | blender-mcp | <----------- | Blender |
| Copilot | | （Node.js） | --后台 | --后台 |
+-----------+ +-------------+ +---------+
```
服务器在后台运行 Blender，并为每个操作执行 Python 脚本，使用 Blender 的 `bpy` API。
---
## 开发
```bash
# 克隆并安装
npm install
# 构建
npm run build
# 运行
npm start
```
---
🌐 **查看我的作品集：** [nishantunavane.qzz.io](https://nishantunavane.qzz.io)
---
## 许可证
MIT 许可证
