BlendDC MCP
数据中心资产工厂
189个生产就绪的工具，用于在Blender中构建逼真的数据中心环境，由任何兼容MCP的AI前端驱动。
BlendDC MCP是Blender的一个插件，它在Blender的Python进程中启动了一个轻量级的MCP服务器。连接Claude、Cursor、LM Studio或任何MCP客户端，然后描述您想要构建的内容——机架、托架、电缆、变体、故障状态、完整的设施部分——并将UE5资产恢复到生产就绪状态。
AI Frontend ──HTTP──▶ BlendDC-MCP Server (inside Blender) ──bpy──▶ Blender Scene
(Claude, FastMCP / uvicorn racks, cables,
Cursor, etc.) http://127.0.0.1:8400/mcp materials, UE5…______________________________________________________________________
它做什么
BlendDC MCP提供了一个涵盖整个数据中心资产管道的AI 189工具，从单个EIA-310机架式机柜到准备好导入UE5的全套多机架设施部分。
完整的管道
create_facility_section ← lay out a grid of bays
└─ create_rack_row ← hot-aisle / cold-aisle row pairs
└─ create_rack_cabinet ← EIA-310 compliant 42U cabinet (origin at base-front-centre)
└─ populate_rack_procedural ← fill with servers, switches, patch panels
└─ route_cables_between_racks ← NURBS cable curves on tray paths
└─ randomize_facility_variation ← procedural wear, dust, damage
└─ apply_facility_theme ← aged_colo / post_incident / crisis
└─ export_facility_layout_json ← UE5 manifest + FBX12个模块中的189个工具
| 模块 | 工具 | 它构建了什么 |
|---|---|---|
server （核心） | 62 | 场景查询、变换、材质、渲染、导出基元、API发现 |
rack_tools | 25 | EIA-310机架式机柜、导轨、门、盲板、电缆管理器 |
mesh_tools | 12 | 硬曲面网格图元、布尔、斜面、倒角 |
gn_tools | 7 | 几何节点设置：EIA孔、穿孔板、电缆束 |
export_tools | 14 | UE5 FBX管道：转换、LOD、清单、套接字嵌入 |
equipment_tools | 9 | 设备打包、机架数量、插槽分配 |
material_tools | 12 | PBR材料、LED状态、拉丝金属、阳极氧化处理 |
bay_tools | 11 | 冷热通道隔间、机架排、活动地板砖、密封 |
cable_tools | 12 | NURBS电缆路径、线束、托盘、配线架、布线验证 |
variation_tools | 11 | 程序磨损、灰尘、损坏节点、故障状态、主题 |
facility_tools | 11 | 多隔间部分、走廊、电源/冷却区、UPS/CRAC |
polish_tools | 12 | 撤消检查点、会话日志、场景清单、文档生成 |
第9阶段安全层
这 polish_tools 该模块为长期资产构建会话添加了专业级安全网：
push_undo_checkpoint--在任何破坏性操作之前，命名Blender撤消步骤confirm_destructive--模拟飞行前clear_cables,reset_variation等等。backup_section_metadata--将所有自定义属性快照为JSON；重新加载后恢复quick_save_scene--时间戳.blend在不接触工作文件的情况下复制suggest_next_step--具有预填充工具参数的场景感知AI建议validate_entire_scene--每次出口前进行一次电话健康检查
______________________________________________________________________
快速开始
# 1. Install the addon (see Installation below)
# 2. In Blender: N-Panel → BlendDC tab → ▶ Start MCP Server
# 3. Connect your AI client to http://127.0.0.1:8400/mcp然后问你的AI：
*“为我建造一个2×3的数据中心隔间，带有热通道密封，在机架之间布线以太网电缆，应用aged_colo变体，然后导出到 /tmp/blenddc_exports/ 作为UE5清单。"*AI呼叫 create_facility_section → route_cables_between_racks → apply_facility_theme → export_facility_layout_json --并在完成后报告。
工具调用示例
# Create a 2×4 facility section, fully populated
create_facility_section(
section_name = "DC_Floor_01",
bays_x = 2,
bays_y = 4,
racks_per_bay = 6,
populate_preset = "standard_3tier",
hot_aisle_containment = True,
)
# Apply a post-incident theme with a named epicentre bay
apply_facility_theme(
section_name = "DC_Floor_01",
theme = "post_incident",
epicenter_bay = "Bay_DC_Floor_01_1_2",
)
# Export the full facility — manifest + cables + variation metadata
export_facility_layout_json(
section_name = "DC_Floor_01",
output_path = "/tmp/blenddc_exports/DC_Floor_01_layout.json",
include_cables = True,
include_variation = True,
)______________________________________________________________________
安装
选项A——预构建zip（推荐）
- 下载
blenddcmcp_v3.0.0.zip从 发布 页 - 打开搅拌机→ Edit → 偏好→ 附加组件→ 安装…
- 选择zip→ 启用 BlendDC MCP-数据中心资产工厂
选项B——从源代码构建
git clone https://github.com/DaRealDaHoodie/BlendDC-MCP.git
cd BlendDC-MCP
python3 build_addon.py # writes dist/blenddcmcp_v3.0.0.zip然后按照上述步骤安装zip。
首次启动
- 按 N 在三维视口中→ BlendDC tab → ▶ 启动MCP服务器
- 在第一次启动时，
fastmcp和uvicorn自动安装到addon/lib/
--不需要系统包，不需要管理员权限
- 系统控制台确认：
[BlendDC-MCP] Schema cache ready — 189 tools in 0.01s
[BlendDC-MCP] Server running — http://127.0.0.1:8400/mcp连接您的AI客户端
克劳德桌面版 (~/.claude/claude_desktop_config.json):
{
"mcpServers": {
"blenddcmcp": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://127.0.0.1:8400/mcp"]
}
}
}光标/继续dev --添加MCP服务器 http://127.0.0.1:8400/mcp 在设置中。
LM 工作室 --MCP服务器→ Add → http://127.0.0.1:8400/mcp.
______________________________________________________________________
运行测试套件
完整的集成测试验证了从Blender外部通过实时MCP端点端到端的管道——通过UE5导出创建设施：
# Start the server in Blender first, then from a terminal:
python3 tests/full_pipeline_test.py
# Override the export directory:
OUTPUT_DIR=~/Desktop/blenddc_test python3 tests/full_pipeline_test.py测试流道涵盖7个阶段和打印 [PASS] / [WARN] / [FAIL] 每次检查都有时间安排和最终总结。只需要Python标准库，不需要额外的包。
══════════════════════════════════════════════════════════════════════
BlendDC PIPELINE TEST SUMMARY (14.3s total)
══════════════════════════════════════════════════════════════════════
Passed : 47
Warned : 3
Failed : 0
✓ ALL TESTS PASSED______________________________________________________________________
建筑
BlendDC-MCP/
├── addon/
│ └── blenddc_mcp/ # Blender addon package
│ ├── __init__.py # bl_info, server start/stop, N-Panel UI
│ ├── core.py # FastMCP instance, @thread_safe, middleware
│ ├── constants.py # EIA-310 dimensions, UE5 axis conventions
│ ├── server.py # 62 core tools + module import registry
│ ├── discovery.py # Blender API keyword search + disk-backed index
│ ├── rag_store.py # TF-IDF doc search over live bpy docstrings
│ ├── rack_tools.py # 25 rack cabinet tools
│ ├── mesh_tools.py # 12 hard-surface mesh tools
│ ├── gn_tools.py # 7 Geometry Nodes tools
│ ├── export_tools.py # 14 UE5 export pipeline tools
│ ├── equipment_tools.py # 9 equipment kitbash + population tools
│ ├── material_tools.py # 12 material + texturing tools
│ ├── bay_tools.py # 11 bay + row generation tools
│ ├── cable_tools.py # 12 cable management + routing tools
│ ├── variation_tools.py # 11 variation + failure state tools
│ ├── facility_tools.py # 11 facility layout + export tools
│ └── polish_tools.py # 12 polish, UX, safety + documentation tools
├── tests/
│ ├── pipeline_test.py # In-Blender test (Scripting workspace)
│ └── full_pipeline_test.py # External integration test (v3.0.0)
├── docs/
│ └── tool_reference.md # Full 189-tool reference (auto-generated)
├── build_addon.py
├── CHANGELOG.md
└── README.md关键设计决策
线程安全 -每个Blender API调用都通过 bpy.app.timers.register()uvicorn HTTP服务器在守护进程线程中运行；这 @thread_safe 装饰器队列工作到主线程和块，直到完成。
抄写材料 --变体工具在注入着色器节点之前复制共享材质，因此不会无意中修改外观相同的邻居。注入的节点被标记 [WEAR], [DUST], [DAMAGE] 通过以下方式进行清洁去除 reset_variation.
独立模块 --每个工具模块都复制所需的帮助程序，而不是从兄弟模块导入，从而防止在服务器热重新加载期间循环导入失败。
内置API发现 — discover_api 和 query_api_docs 工具（由支持 discovery.py 和 rag_store.py)让AI客户端搜索Blender的直播 bpy.ops, bpy.types，以及 bpy.data 写作前按关键字或自然语言 execute_safe_python 代码。索引只构建一次，并缓存到磁盘上，以便立即进行后续加载。
符合EIA-310标准 --每U 44.45毫米，482.6毫米内轨跨度，机架原点位于底座前部中心。所有尺寸均已根据实际机架数据表进行验证。
UE5轴惯例 --FBX导出使用 -X 向前地， Z 起来(axis_forward='-X', axis_up='Z')at FBX Units Scale 因此，机架以正确的实际米级导入，无需手动校正。
______________________________________________________________________
生成工具参考
带有参数表的完整189个工具参考是从实时文档字符串自动生成的。启动服务器并询问您的AI：
export_tool_reference(
output_path = "/path/to/BlendDC-MCP/docs/tool_reference.md",
format = "markdown",
)请参阅当前参考文献： docs/tool_reference.md
______________________________________________________________________
设计目标
BlendDC MCP是一个通用的数据中心资产工厂。每个设计决策都反映了现实世界的准确性：
- 现实世界维度 --机架、设备、电缆和通道符合实际的数据中心规范（EIA-310、TIA-942）
- 变化系统 --老化的设备、事故后的故障状态和热区磨损梯度为每个部分提供了可信的历史记录
- UE5首次出口 —
SOCKET_附着点、LOD集、清单和样条线就绪电缆控制点是为UE5的StaticMesh和PCG工作流设计的 - 设施规模输出 --单身
create_facility_section调用生成一个完整的、填充的、变体修饰的部分，准备用于UE5级导入
______________________________________________________________________
需求
- 搅拌机 4.0或更新版本 （在4.x和5.x上测试）
- 首次启动时访问互联网（安装
fastmcp和uvicorn进入addon/lib/) - 任何兼容MCP的AI客户端
______________________________________________________________________
许可证
麻省理工学院+公共条款 --©2026 PiMP工作室
免费使用、修改和重新分发。未经商业许可，您不得销售软件本身或其价值实质上来自软件的产品。
______________________________________________________________________
*BlendDC MCP是一个独立的项目，不隶属于Autodesk、Epic Games或Anthropic。*