AI导哈

Blender MCP 服务器

Blender MCP 服务器是一个AI驱动的3D创作工具，通过自然语言控制Blender进行3D模型创建、材质应用、网格雕刻等操作。

  • by mezallastudio
  • TypeScript
  • 本地部署
  • 62 星标
  • 更新于
在 GitHub 查看 mezallastudio/antigravity-blender-mcp

使用说明

🎨 Blender MCP服务器v2

人工智能驱动的反重力IDE 3D创建

支持生产的MCP（模型上下文协议）服务器 谷歌双子座3 Pro 通过自然语言直接控制Blender。创建3D模型、应用材质、雕刻网格等，所有这些都可以通过文本提示完成。

✨ 特性

  • 🤖 AI优先设计 -针对反重力IDE和Gemini 3 Pro进行了优化
  • 🔧 17强大的工具 -从图元到人工智能辅助雕刻
  • 📐 蓝图系统 -结构模型生成（建筑物、武器、车辆、角色）
  • 🎨 AI纹理 -通过AI生成和应用纹理
  • 👁️ 视觉反馈 -AI可以“看到”渲染和修改模型
  • ⚡ 令牌优化 -紧凑的响应，实现LLM的高效使用
  • 🖥️ Windows本机 -在Windows 10/11上运行良好

🛠️ 可用工具（共17个）

# 工具 说明
1 status 检查搅拌机连接
2 scene 列出场景中的对象
3 prim 创建基本体（立方体、球体、圆柱体等）
4 export 出口型号（GLB、FBX、OBJ）
5 tex 从文件中应用纹理
6 mat 设置材料（金属、玻璃、木材、光泽等）
7 proc 程序生成（树木、岩石、地形）
8 opt 优化/抽取网格
9 render 全质量渲染
10 bake 烘焙纹理（法线、AO、漫反射）
11 gentex AI纹理生成+应用
12 pipe 分步工作流编排器
13 parse 从结构上分析提示
14 blueprint 从结构生成复杂模型
15 sculpt 人工智能辅助网格修改
16 preview AI视觉反馈的快速渲染
17 run 执行自定义Python/bpy代码

📋 需求

  • 搅拌机 4.0+（在4.2+上测试）
  • Node.js 18+
  • 反重力IDE 随着 双子座3 Pro（高） 模型
  • 视窗 10/11（macOS/Linux应该可以工作，但没有经过测试）

⚠️ 重要提示： 此MCP针对以下方面进行了优化 双子座3 Pro（高） 只有模型。由于3D生成任务和工具调用要求的复杂性，其他模型可能无法正常工作。

🚀 安装

步骤1：克隆存储库

git clone https://github.com/YOUR_USERNAME/blender-mcp-v2.git
cd blender-mcp-v2

步骤2：安装节点依赖关系

cd src/mcp-server
npm install
npm run build

步骤3：安装Blender插件

  1. 打开 搅拌机4.0+
  2. 首选 Edit → 偏好设置→ 附加组件
  3. 点击 安装。..
  4. 导航至 blender-mcp-v2/mcp_connector_v2.py
  5. 选择文件并单击 安装附加组件
  6. ✅ 启用复选框 “接口：MCP连接器v2”
  7. 点击 保存首选项

步骤4：启动Blender服务器

  1. 在Blender中，按 N 打开侧边栏
  2. 查找 主控程序 标签
  3. 点击 启动服务器
  4. ✅ 状态应显示： Running on ws://127.0.0.1:9876

步骤5：配置反重力IDE

编辑MCP配置文件：

  • 窗户： C:\Users\{username}\.gemini\antigravity\mcp_config.json
  • macOS/Linux： ~/.gemini/antigravity/mcp_config.json

添加以下配置：

{
  "mcpServers": {
    "blender-mcp": {
      "command": "node",
      "args": ["C:/FULL/PATH/TO/blender-mcp-v2/src/mcp-server/dist/index.js"],
      "env": {
        "BLENDER_HOST": "127.0.0.1",
        "BLENDER_PORT": "9876"
      }
    }
  }
}

⚠️ 重要提示： 替换 C:/FULL/PATH/TO/ 你的实际路径。使用正斜杠 / 甚至在Windows上。

步骤6：重新启动反重力IDE

重新启动IDE以加载新的MCP服务器。

步骤7：验证连接

在Antigravity IDE中，尝试以下提示：

Check Blender connection status

您应该看到这样的响应：

{"ok":1,"v":"4.2.0","objs":3}

💡 使用示例

基本对象创建

Create a red metallic cube in Blender

带蓝图的复杂模型

Create a cyberpunk building with neon signs

人工智能辅助雕刻

Take that sphere and add horns, make it look like a demon head

过程生成

Generate a low-poly tree for my game scene

完整工作流程

Create an AWP sniper rifle, low poly style, optimize for mobile, export as GLB

🏗️ 建筑

┌─────────────────────────────────────────────────────────────────┐
│                                                                  │
│  Antigravity IDE (Gemini 3 Pro)                                │
│         │                                                        │
│         │ stdio (MCP Protocol)                                  │
│         ▼                                                        │
│  TypeScript MCP Server (17 tools)                               │
│         │                                                        │
│         │ WebSocket (ws://127.0.0.1:9876)                       │
│         ▼                                                        │
│  Python Addon (mcp_connector_v2.py)                             │
│         │                                                        │
│         │ bpy (Blender Python API)                              │
│         ▼                                                        │
│  Blender 4.x                                                     │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

📁 项目结构

blender-mcp-v2/
├── mcp_connector_v2.py          # Blender addon (install this)
├── src/
│   ├── mcp-server/              # TypeScript MCP server
│   │   ├── src/
│   │   │   ├── index.ts         # Entry point
│   │   │   ├── server.ts        # MCP server + tool registration
│   │   │   ├── bridge/          # WebSocket client to Blender
│   │   │   ├── tools/           # All 17 tools
│   │   │   └── utils/           # Logger, config
│   │   ├── dist/                # Compiled JS (after build)
│   │   └── package.json
│   └── blender-addon/           # Addon source (reference)
└── README.md

🔧 发展

构建

cd src/mcp-server
npm run build

观看模式

npm run dev

测试连接

# In a new terminal
node dist/index.js

❓ 故障排除

“连接失败”错误

  1. 确保Blender正在运行
  2. 检查Blender首选项中是否启用了MCP插件
  3. 点击 启动服务器 在MCP面板中
  4. 验证状态是否显示“正在运行”

工具“无响应”

  1. 检查Blender系统控制台是否有错误
  2. 验证WebSocket端口是否为9876
  3. 尝试重新启动Blender和Antigravity IDE

“无效路径”错误

  • 使用正斜杠 / 在mcp_config.json中，甚至在Windows上
  • 使用完整的绝对路径，而不是相对路径

插件未在Blender中显示

  1. 确保您已安装 mcp_connector_v2.py （不是文件夹）
  2. 检查Blender版本是否为4.0+
  3. 查找 Edit → 偏好设置→ 附加组件 并搜索“MCP”

🎯 设计用于

本项目专为以下目的而设计：

  • 反重力IDE -人工智能驱动的开发环境
  • 谷歌双子座3 Pro -作为理解3D概念的LLM大脑
  • 快速3D原型制作 -创建游戏资产、架构概念等

📜 许可证

MIT许可证-您可以自由使用、修改和分发。

🙏 鸣谢

为Antigravity IDE生态系统开发。

特别感谢Blender和MCP社区。

由...制作❤️ 用于人工智能驱动的3D创作

相关 MCP