BlendDC-MCP v3.0.0 — 189 Tools, Full Facility Pipeline, Phase 9 Safety Layer

What's New in v3.0.0

Project Rename

• Renamed from Universal Blender MCP → BlendDC-MCP
• Internal package renamed from `universal_blender_mcp` → `blenddc_mcp`
• Blender N-Panel now shows BlendDC tab

198 Tools Across 12 Modules

Module	Tools	Description
rack_tools	25	Parametric rack cabinets, doors, rails, metadata
mesh_tools	18	Geometry editing, modifiers, UV, normals
gn_tools	12	Geometry Nodes, EIA holes, cable trays
export_tools	22	UE5 FBX export, LODs, bake, ORM pack, manifest
equipment_tools	20	Servers, switches, patch panels, PDUs, sockets
material_tools	18	PBR materials, rack/cable/LED materials, themes
bay_tools	16	Bay layout, rack rows, presets, validate
cable_tools	15	Cable paths, bundles, routing, export
variation_tools	11	Wear, dust, damage, failure states, propagation
facility_tools	11	Multi-bay sections, corridors, themes, full export
polish_tools	12	Undo checkpoints, session log, quick save, scene inventory, tool reference export
core/server	18	Discovery, RAG docs, safe exec, scene info

Phase 9 — Polish, Safety & Production Readiness (New)

• push_undo_checkpoint — named undo steps before destructive ops
• confirm_destructive — dry-run gate with auto-undo before execution
• quick_save_scene — timestamped .blend backup with one call
• get_scene_inventory — full object/material/collection census
• backup_section_metadata / restore_section_metadata — save/restore collection custom properties
• validate_entire_scene — cross-module validation pass
• suggest_next_step — context-aware next-step guidance
• log_operation / get_session_log — persistent session audit trail
• list_all_tools / export_tool_reference — live tool registry + markdown/JSON docs

Bug Fixes

• bmesh.ops.create_box → create_cube (Blender 5.1 API change) across 5 modules
• bay_tools.create_rack_row: fixed collection_name= → name= parameter mismatch

Test Suite

• tests/full_uptime_pipeline_test.py — 34-check external integration test (stdlib only)
• tests/uptime_pipeline_test.py — in-Blender smoke test

Installation

1. Download blenddcmcp_v3.0.0.zip
2. Blender → Edit → Preferences → Add-ons → Install…
3. Select the zip → enable BlendDC-MCP
4. N-Panel → BlendDC tab → Start MCP Server

Requires Blender 4.0+ (tested on 5.1)

v2.0.0 — Rack-first architecture + UE5 pipeline

What's New in v2.0.0

UPTIME Datacenter Simulator — Phase 1

This release overhauls the addon architecture with a rack-first, UE5-focused design for the UPTIME datacenter operations simulator.

New: 14 Rack Cabinet Tools

• create_rack_cabinet — Generates a complete EIA-310 4-post enclosed rack cabinet
  • Real-world scale: 42U interior = 1866.9 mm (42 × 44.45 mm)
  • EIA-310 19" standard: 482.6 mm rail span (inner face to inner face)
  • Continuous L-bracket mounting rails on all 4 post inner faces
  • Full side panels, top cap, base plinth, door hinge pins, latch receivers
  • Origin at base-front-centre for UE5 import
  • join_mesh=True default exports as single clean mesh
• get_rack_u_position — World-space coordinates for any U slot
• get_rack_rail_positions — All slot positions as JSON (UE5 DataTable-ready)
• create_rack_row — Row of N identical racks spaced along X or Y
• snap_to_rack_u — Snap equipment models to a rack U slot
• add_rack_blanking_panel — Add sheet-metal blanking panels
• validate_rack_fitment — Check if equipment fits before placing
• export_rack_layout_json — Export layout JSON for UE5 DataTable
• Plus: list_rack_collections, get_rack_info, set_rack_material, duplicate_rack, delete_rack, update_rack_metadata

New: 11 Hard-Surface Mesh Tools

bevel_edges, boolean_operation, mark_sharp_edges, clear_sharp_edges, add_weighted_normal_modifier, recalculate_normals, flip_normals, check_mesh_errors (with UE5 20k tri limit check), bridge_edge_loops, add_solidify_modifier, add_bevel_modifier

New: 6 Geometry Nodes Tools

add_gn_modifier, set_gn_input, get_gn_inputs, list_gn_modifiers, apply_gn_modifier, list_gn_node_groups

New: 6 UE5 Export Tools

export_ue5_fbx (−X forward, Z up, FBX_SCALE_ALL), batch_export_ue5, create_ucx_collision (BOX/CONVEX/CAPSULE), create_ue5_socket, validate_ue5_asset, apply_ue5_transforms

Architecture Changes

• constants.py — All EIA-310 and UE5 constants in one place
• core.py — Single shared mcp instance, thread_safe decorator, middleware
• server.py — Now imports from core.py; removed unsafe execute_python
• Response-size limit added to list_objects (default 200, configurable)

Total tools: 96 (59 original + 37 new)

---

Installation

Download universal_blender_mcp_v2.0.0.zip and install via Edit → Preferences → Add-ons → Install…

v1.4.1 — Windows 11 compatibility fix

What's New in v1.4.1

Windows 11 Fix

• Dependencies (fastmcp, uvicorn) now install into a local lib/ folder inside the addon directory instead of Blender's system Python — no admin rights required on Windows
• Windows install uses mcp and uvicorn (without optional extras) to avoid pulling in pywin32 / prompt_toolkit / rich which have no Windows wheels in Blender's Python
• pywin32 DLL paths (win32/, win32/lib/, pywin32_system32/) are registered automatically on Windows so pywintypes313.dll is found correctly
• Mac and Linux behavior is unchanged

Install

Download universal_blender_mcp_v1.4.1.zip below and install via Edit → Preferences → Add-ons → Install from Disk…

v1.4.0 — UV Unwrap, Texture Wiring, Batch Export, Bake, Mesh Edit

What's New in v1.4.0

Five new tools targeting hard-surface asset pipelines (e.g. Roblox datacenter props):

UV & Texturing

• unwrap_uv — UV unwrap a mesh in Edit Mode. Supports smart_project (default, recommended for hard-surface), unwrap, and cube_project. Takes angle_limit (degrees) and island_margin.
• set_material_texture — Load an image file and wire it into a Principled BSDF channel (BASE_COLOR, NORMAL, ROUGHNESS, METALLIC, EMISSION). Color-space is set automatically; a Normal Map node is inserted automatically for the NORMAL channel.

Export

• batch_export — Export every mesh in a collection as a separate file. Supports FBX and GLB. Applies transforms per object before export. Returns a list of all written file paths.

Baking

• bake_texture — Bake from a high-poly object onto a low-poly using Cycles selected_to_active. Supports NORMAL, AO, DIFFUSE, and ROUGHNESS. Saves result as PNG. Render engine is restored after baking.

Mesh Editing

• edit_mesh — BMesh-based mesh operations: loop_cut, inset, extrude_region, merge_by_distance, and set_smooth_shading. Uses bmesh directly for reliable scripted use (no interactive operators).

UI

• The N-Panel now shows the loaded addon version (v1.4.0) at the top of the MCP panel.

---

Total tools: 59 static + 3 advanced = 62

Install

Download universal_blender_mcp_v1.4.0.zip below and install via Edit → Preferences → Add-ons → Install…

v1.3.0 — Dynamic Discovery + TF-IDF Docs + Safe Exec

What's new

Three new tools that let the agent reach Blender's full ~3000-entry API surface using a discover → docs → execute chain — without bloating the tool list.

discover_api

Searches bpy.ops.*, bpy.types.*, and bpy.data.* with keyword + fuzzy matching. Index built once on first call (~3 s) and cached to disk. Pass rebuild_cache=True to refresh after a Blender update.

query_api_docs

TF-IDF search over every bpy operator and type docstring. Pure Python stdlib — zero new dependencies. Cache persists across server restarts.

execute_safe_python

Hardened replacement for bare execute_python:

• Pushes an undo step first (all changes reversible via Ctrl-Z)
• dry_run=True validates syntax and flags dangerous patterns without executing
• Captures a result variable from your code
• Sanitizes output (no raw bpy objects in the response)
• Rate-limited to 10 calls per 60 seconds

Agent workflow

discover_api("bevel")               # find the operator
query_api_docs("bevel edges mesh")  # understand the parameters
execute_safe_python("""             # call it safely
import bpy
bpy.ops.mesh.bevel(offset=0.1, segments=2)
result = "Bevel applied"
""", push_undo=True)

All 54 existing tools are unchanged.

Install

1. Download universal_blender_mcp_v1.3.0.zip
2. In Blender: Edit > Preferences > Add-ons > Install... → select the zip → enable
3. Open the MCP N-panel tab → Start MCP Server

v1.2.0 — Streamable HTTP transport

What's new

Streamable HTTP transport (replaces SSE)

The server now uses the MCP Streamable HTTP transport (POST /mcp) instead of the older SSE transport (GET /sse + POST /messages/). Streamable HTTP is the current spec direction and is supported by all major MCP clients (Claude Desktop, Cursor, Continue, etc.).

Update your client config endpoint from:

http://127.0.0.1:8400/sse

to:

http://127.0.0.1:8400/mcp

Compatibility fixes

• Detects the correct transport method across mcp package versions (streamable_http_app → http_app → sse_app fallback chain)
• outputSchema is still stripped from tools/list responses for clients that don't implement the 2025-06-18 spec

Install

1. Download universal_blender_mcp_v1.2.0.zip
2. In Blender: Edit > Preferences > Add-ons > Install... → select the zip → enable the addon
3. Open the Universal Blender MCP panel (N-panel) and click Start MCP Server