SSyncDev

DESIGN:OS 3D Blender MCP Server

Lets a coding agent model, render and gate-check millimetre-accurate mechanical parts in a local Blender 5.2.

Local server

What is the DESIGN:OS 3D Blender MCP Server?

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.

Mechanical parts, measured in millimetres

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.

What the agent gets

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.

Setting it up

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.

Where it stops

  • Sheet-metal or paperboard folding, where 2D crease patterns govern the shape, is out of scope.
  • Organic character sculpting and full game-character rigs are not what it is for.
  • 2D vector UI motion belongs elsewhere.

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.

Recorded 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.

ToolWhat it does
blender_runtime_statusReports host, Python and whether a Blender 5.2 binary is available. Intended as the first call.
query_blender_knowledgeSearches the bundled bpy 5.2 knowledge base before a script is written.
validate_part_specValidates a spec.json: millimetre units, target dimensions, tolerance and minimum wall thickness.
execute_blender_passRuns a headless Blender pass and returns the AGENT_OK or AGENT_FAIL verdict line.

How to install the DESIGN:OS 3D Blender MCP Server

/plugin marketplace add jangtrinh/design-os-3d-blender
/plugin install design-os-3d-blender@design-os-3d-blender

Run both lines inside Claude Code. Blender 5.2 must be installed locally.

Configuration

VariableDescriptionRequired
BLENDER_BINAbsolute path to the Blender 5.2 executable the server should run headlessly.Yes

Frequently asked questions

Yes. It runs your own Blender 5.2 binary headlessly, located through the BLENDER_BIN setting. The runtime status tool tells you if the binary cannot be found.