Blender Orchestrator

代理混音器编排器

使用自然语言在Blender中创建3D模型。MCP服务器允许代理直接控制Blender，使您能够通过对话构建复杂的3D场景。场景理解工具和技能使LLM提高了空间意识，从而获得了更好的结果。

______________________________________________________________________

仅根据Claude Opus 4.6的提示创建的示例

特性

🧠 空间智能套件

空间智能套件帮助AI理解空间。

• 自然语言定位 --说“把灯放在床头柜上”，它就会计算出坐标，检查碰撞，并处理堆叠。
• 真实世界尺寸数据库 --55多种常见物品（家具、电器、装饰），具有准确的现实测量值。人工智能知道厨房柜台高0.9米，门口宽2.1米×0.9米。
• 碰撞检测和安全移动 --在应用转换之前验证转换。查询一个物体在每个方向上可以移动多远而不会碰到任何东西。
• 空间查询 --问“桌子上有什么？”或“门边有什么。
• 场景构建指南 --全面 参考文件 AI代理可以在构建场景之前阅读，包括房间尺寸、放置规则、常见错误和工作示例。

🗺️ 多视图ASCII平面图

ASCII可视化工具为LLM提供了一种理解对象之间空间关系的方法。从任何角度渲染场景——顶部、底部、前部、后部、左侧、右侧，或同时渲染所有六个角度。可配置分辨率高达120×120个单元。

--- Top (looking down, +Z) ---
Axes: horizontal=X, vertical=Y | 5.3m x 4.3m (cell: 0.25m, grid: 21x17)

WWWWWWWWWWWWWWWWWWWWW
W...................W
W...................W
W..TTTTTT..........W
W..TTTTTT..........W
W..TTTTTT....SS....W
W............SS....W
W...................W
W.......CCCC.......W
W.......CCCC.......W
W...................W
WWWWWWWWWWWWWWWWWWWWW

Legend: C=Couch, S=Shelf, T=Table, W=Wall_Back

💡 完整的照明系统

完全控制所有四种Blender灯光类型——点光源、日光光源、聚光灯和区域光源。设置颜色、强度、阴影属性、锥角等。以前只有HDRI环境照明可用；现在，您可以构建精确的工作室设置、戏剧性的聚光灯或温暖的室内场景。

📷 摄影机工具

创建透视、正交和全景相机。产品快照的自动框对象。设置景深，调整镜头焦距，控制剪裁平面。对于渲染场景的合成镜头至关重要。

🏠 房间创建

一个命令可以创建一个具有地板和四面墙的适当尺寸的房间。指定宽度、深度、高度和壁厚，然后开始装修。结合尺寸数据库和空间工具，人工智能可以从一个提示中提供一个逼真的房间。

🌍 插件模型和纹理生成服务

可扩展的架构允许您插入您选择的纹理和模型生成服务，包括Replicate、Meshy、Stability.ai等。

内置访问数千个免费CC0资产的权限 保利港湾 -不需要API密钥。下载用于环境照明的HDRI、用于逼真材质的PBR纹理集以及即用型3D模型。所有资产均获得CC0许可（免费使用，无需归因）。

______________________________________________________________________

为什么使用这个？

• 空间智能人工智能能够理解现实世界的维度，检测碰撞，以及物体关系的原因，而不仅仅是坐标。
• 人工智能发电：使用网格和稳定性AI从文本描述或参考图像生成3D网格。
• 完整的场景控制：照明、摄影机、材质、渲染——从空场景到完成渲染所需的一切。
• 快速原型制作：通过对话迭代设计，获得即时的视觉反馈。
• VR就绪出口：使用内置平台预设优化和导出Meta Quest和Horizon Worlds的模型。
• 自由资产：来自Poly Haven的数千个CC0 HDRI、纹理和模型-无需API密钥。

快速开始

需求

• 搅拌机4.0+
• Python 3.10+
• uv（推荐）或pip

安装

1.安装Python依赖项

cd /path/to/blender-orchestrator
uv venv && source .venv/bin/activate
uv pip install -e .

2.安装Blender插件

python scripts/install_addon.py

或手动：搅拌机→ Edit → 偏好→ 附加组件→ 安装→ 选择 blender_addon 文件夹→ 启用“Blender MCP桥”

3.配置代理

添加到代理桌面配置(~/Library/Application Support/Agent/Agent_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "blender": {
      "command": "uv",
      "args": ["--directory", "/path/to/blender-orchestrator", "run", "blender-mcp"]
    }
  }
}

对于Claude Code CLI，请将其添加到 .claude/settings.json.

用法

1. 打开搅拌机
2. 按 N 在三维视口中→ MCP选项卡→ 点击“启动服务器”
3. 开始和克劳德谈论你的3D场景

______________________________________________________________________

特性

图元和变换

创建和操纵基本形状，完全控制位置、旋转和比例。

网格编辑

使用专业建模操作修改几何图形。

过程生成

创造复杂的有机和几何形状。

材料和纹理

完全支持PBR材质，支持AI驱动的纹理生成。

渲染和可视化

照明

创建和控制灯光，以实现逼真或风格化的场景照明。

相机

创建和定位用于渲染和可视化的摄影机。

空间推理与场景智能

用于理解和操纵具有真实空间感知的场景布局的工具。

请参阅 场景构建指南 了解详细的使用模式和示例。

场景管理

人工智能驱动的3D生成

使用云AI API从文本或图像生成完整的3D模型。

VR优化

用于优化VR平台3D资产的工具。

Poly Haven（自由资产）

从以下网址访问数千个免费CC0资产 保利港湾.

______________________________________________________________________

AI生成设置

使用网格生成3D网格，使用复制生成纹理。

配置

通过环境变量设置API键：

export MESHY_API_KEY="msy_your_key_here"
export REPLICATE_API_TOKEN="r8_your_token_here"

或创建 ~/.config/blender-mcp/ai_providers.json:

{
  "meshy": { "api_key": "msy_your_key_here", "timeout": 600 },
  "replicate": { "api_key": "r8_your_token_here", "timeout": 300 }
}

可用供应商

文本到3D示例

"Generate a wooden treasure chest"
"Create a cartoon dog in the scene"
"Make a realistic medieval castle tower"

艺术风格： realistic, cartoon, sculpture, pbr

图像到3D提示

• 在干净的背景上使用单个对象的图像
• 确保良好的照明和集中构图
• 避免杂乱的场景

API成本

• 网状：基于学分，每代约20学分。看 meshy.ai/定价
• 复制：按次付费，每种质地约0.002美元。看 replace.com/pricing

______________________________________________________________________

VR优化

内置工具，用于优化VR平台的3D资产，并为Meta Horizon Worlds预设。

平台预设

验证

检查您的模型是否已准备好VR：

validate_for_vr(
    object_name="Chair",
    platform="horizon_worlds"
)

返回多边形数量、纹理大小和材质问题的警告。

优化

自动优化模型：

optimize_for_vr(
    object_name="Chair",
    platform="horizon_worlds",
    target_triangles=10000,
    merge_by_distance=True
)

LOD生成

创建细节级别变体：

generate_lod_chain(
    object_name="Chair",
    lod_levels=[1.0, 0.5, 0.25, 0.1]
)

GLB出口

导出优化场景：

export_vr_scene(
    output_path="/path/to/scene.glb",
    platform="horizon_worlds",
    include_all_objects=True
)

______________________________________________________________________

保利港湾一体化

从以下网址访问数千个免费CC0资产 保利港湾 -不需要API密钥。

搜索资产

search_polyhaven(
    query="brick",
    asset_type="texture",
    limit=10
)

资产类型： hdri, texture, model

下载HDRI照明

应用逼真的环境照明：

download_polyhaven_hdri(
    asset_id="industrial_sunset_02",
    resolution="4k",
    apply_to_scene=True
)

下载纹理

获取完整的PBR纹理集：

download_polyhaven_texture(
    asset_id="brick_wall_02",
    resolution="2k",
    apply_to_object="Cube"
)

下载型号

导入即用型3D模型：

download_polyhaven_model(
    asset_id="wooden_chair",
    import_to_scene=True,
    location=[0, 0, 0]
)

浏览分类

list_polyhaven_categories(asset_type="textures")

所有Poly Haven资产均为 CC0许可 --免费使用，无需注明出处。

______________________________________________________________________

故障排除

“无法连接到Blender服务器”

• 确保Blender在启用MCP Bridge插件的情况下运行
• 单击MCP面板中的“启动服务器”（按 N → MCP选项卡）
• 检查端口8765是否可用

“找不到对象”

• 对象名称区分大小写
• 使用 list_objects 查看确切名称

手动测试连接：

curl http://localhost:8765/health

______________________________________________________________________

建筑

blender-orchestrator/
├── blender_addon/          # Blender add-on (HTTP server + handlers)
│   ├── server/             # Non-blocking HTTP server
│   ├── handlers/           # Operation implementations
│   └── templates/          # Character templates
│
├── mcp_server/             # MCP server
│   ├── server.py           # FastMCP entry point
│   ├── blender_client.py   # HTTP client for Blender communication
│   ├── tools/              # Tool definitions (one module per category)
│   └── ai_clients/         # AI provider implementations
│
└── scripts/                # Installation helpers

添加新工具

1. 在中创建处理程序 blender_addon/handlers/
2. 注册于 blender_addon/handlers/__init__.py
3. 在中创建MCP工具 mcp_server/tools/
4. 注册于 mcp_server/tools/__init__.py

______________________________________________________________________

许可证

麻省理工学院