design-os-3d-blender

design:os · 3D Blender · agent operating system

An AI agent that builds parts natively in Blender, and shows its evidence.

Agent skills, a verified bpy knowledge base, an AGENT_OK / AGENT_FAIL execution contract and a production gate for Blender 5.2 LTS. Every worked build below ships with what was checked and what was not.

Live site · Installation · MCP config · Worked builds · Host tests · design:os ecosystem

Native renders from the worked builds

DC-01 desktop companion	CK-001 reference keyboard	Robot arm

Rendered in Blender, no added captions or banners. Names, development status and evidence limits live next to each build. Media provenance · the full set on the live site.

Worked builds

Nodestack · project story

Read the Nodestack review r03 & watch the assembly guide (stills r02, archive r01) — a Blender native modular-storage study with 2×2, 2×3 and 4×2 digital configurations. OpenAI Dots coordinated Antigravity planning/building and separate evidence-based reviews, featuring a 102s procedural assembly-guide video, verified 7-view still gallery, and base-seating engineering analysis.

The reference design is NODESTACK // SERVICE PACK by SMACKMAX_. Geometry/export checks cover 32/45/68 parts; physical print, fit, load and strength remain unverified. This publication shares an authorized 102s procedural assembly guide and native still views; raw geometry downloads and other unreviewed videos are held while reference-design redistribution rights remain unverified. Tool attribution does not imply OpenAI endorsement.

Two builds ship a public review page with the delivered package beside it.

Mechanical products

Geothermal ORC components

ORC images are derivatives of native renders; their source models are not in this public checkout.

The plant layout uses an illustrative 1:15 scale. Catalogue dimensions and installation manuals support specific modeling decisions; they do not establish a selected vendor package, plant capacity or as-built engineering design. A component gallery is not evidence that the complete site has been integrated or qualified.

Reusable parts

Instrument families and mounting details show the parts shared across assemblies. Reuse requires a defined local origin, a mounting interface, supported parameters and verification in the receiving assembly.

Installation

Run directly via uvx (zero local package install required):

uvx design-os-3d-blender

Or run from GitHub source:

uvx --from git+https://github.com/jangtrinh/design-os-3d-blender design-os-3d-blender

Or install via pip:

pip install design-os-3d-blender

MCP client configuration

Add the paste-ready block to your client configuration:

Quickstart (Knowledge & Specs — runs anywhere with zero Blender installation)

{
  "mcpServers": {
    "design-os-3d-blender": {
      "command": "uvx",
      "args": ["design-os-3d-blender"]
    }
  }
}

Full Execution Mode (With local Blender 5.2 LTS)

{
  "mcpServers": {
    "design-os-3d-blender": {
      "command": "uvx",
      "args": ["design-os-3d-blender"],
      "env": {
        "BLENDER_BIN": "/Applications/Blender.app/Contents/MacOS/Blender"
      }
    }
  }
}

Client Setup Locations

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).
• Cursor: Open Settings → Features → MCP → Click Add New MCP Server → Name: design-os-3d-blender, Type: command, Command: uvx design-os-3d-blender.
• Antigravity / Codex: Add to your MCP configuration in antigravity.json or .gemini/antigravity/mcp_config.json.
• Cline / Roo Code / Windsurf: Add the JSON snippet above to your client's MCP configuration settings.

User Guide: For Humans

Why use this MCP server?

1. Eliminate BPY Hallucinations: General LLMs frequently hallucinate outdated Blender 2.7x/3.x APIs (deprecated operators, obsolete socket names). This server equips your agent with a verified Blender 5.2 LTS knowledge base.
2. Automated Mechanical Validation: Have your AI automatically audit .spec.json files for wall thickness, watertight manifoldness, and fastener clearances before 3D printing.
3. Headless Generation: Direct the AI to build parts and verify geometry in the background without needing to manually launch or click in the Blender GUI.

Example Prompts to Ask Your AI

• "Check my Blender environment and verify if headless execution is ready."
• "Query the design-os knowledge base for how to set up procedural Chamfer and Bevel modifiers in Blender 5.2 without bpy.ops."
• "Validate the mechanical specification at specs/examples/bracket-m3.spec.json."
• "Execute the modeling pass builds/my-part/pass-01.py and verify the AGENT_OK sentinel."

Agent Guide: For AI Assistants & LLMs

Binding Execution Contract for AI Agents: When this MCP server is active, agents MUST adhere to the following deterministic workflow:

flowchart LR
    A["User Request"] --> B["1. Query Knowledge"]
    B --> C["2. Author & Validate Spec"]
    C --> D["3. Build Script (Data API)"]
    D --> E["4. Execute Pass & Verify Sentinel"]

1. Tool Selection Matrix