Lets a coding agent model, render and gate-check millimetre-accurate mechanical parts in a local Blender 5.2.
Ask a coding agent for a mounting bracket and you normally get a Python script that may or may not run, and may or may not produce the shape you described. The DESIGN:OS 3D Blender MCP server narrows that gap. It lets the agent drive a real Blender 5.2 install headlessly on your own machine. It also refuses to count a clean exit code as proof of anything.
Every executed pass ends with one machine-readable line, AGENT_OK or AGENT_FAIL, and that line is the verdict the agent works from.
The scope is deliberately tight. Specs are locked to millimetres, exports are STL and glTF, and a 3D-print production gate checks for manifold geometry, adequate wall thickness and bounds that match the spec. Worked builds shipped with the project include a compact keyboard taken from a photo to a printable kit, a desk robot with printed parts and a carrier board, a printable robot arm with gated print plates, and a modular storage system.
| Tool | Use |
|---|---|
blender_runtime_status |
Reports the host, Python and whether a Blender 5.2 binary can be found. Call it first. |
query_blender_knowledge |
Searches a bundled, checked bpy 5.2 knowledge base before a script is written |
validate_part_spec |
Checks a spec.json for millimetre units, target dimensions, tolerance and minimum wall |
execute_blender_pass |
Runs a headless pass and returns the AGENT_OK / AGENT_FAIL line |
Two prompts, design_parametric_part and review_geometry_gate, and two resources (a knowledge index and an example bracket spec) sit beside the tools. They are helpers, not extra tools.
You need Blender 5.2 installed locally. Claude Code users can add it through the plugin marketplace in two commands. Everyone else clones the project, runs python3 scripts/self_check.py as an offline sanity check, installs it with pip install ., and points their client at the design-os-3d-blender command. The one required setting is BLENDER_BIN, the path to your Blender binary; on Linux that is often /usr/bin/blender. If you use uv, uv run design-os-3d-blender from the checkout starts the same server. A wrong path is not silent: the status tool says so.
The skill files also install into Codex, Gemini CLI, Antigravity and other agent harnesses, and a read-only /doctor command reports what is installed and whether Blender is reachable.
The DESIGN:OS 3D Blender MCP server sends nothing off your machine. It is free and source-available under PolyForm Shield 1.0.0, so read those terms before reusing the code. If you are comparing options, see Bonsai MCP, the TRELLIS Blender Plugin, or the rest of our design and creative tools.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| blender_runtime_status | Reports host, Python and whether a Blender 5.2 binary is available. Intended as the first call. |
| query_blender_knowledge | Searches the bundled bpy 5.2 knowledge base before a script is written. |
| validate_part_spec | Validates a spec.json: millimetre units, target dimensions, tolerance and minimum wall thickness. |
| execute_blender_pass | Runs a headless Blender pass and returns the AGENT_OK or AGENT_FAIL verdict line. |
/plugin marketplace add jangtrinh/design-os-3d-blender
/plugin install design-os-3d-blender@design-os-3d-blenderRun both lines inside Claude Code. Blender 5.2 must be installed locally.
| Variable | Description | Required |
|---|---|---|
| BLENDER_BIN | Absolute path to the Blender 5.2 executable the server should run headlessly. | Yes |
Feed real design data to your coding assistant — layout, tokens and components straight from Figma files.
Integrates Figma's API with Claude and other Model Context Protocol (MCP) compatible clients, providing read-only access to Figma files and projects.
MCP server for easy access to education data through your Canvas LMS instance.
Open Models MCP for Blender Using Ollama
MasterGo MCP standalone service
Official MCP server for AppsAI - connect Claude Code to your AppsAI projects