# design-os-3d-blender

> design-os-3d-blender is an open-source MCP server for design and media. MCP server and agent skill that models, renders and checks 3D parts in Blender 5.2. It is available on CLI, macOS, Linux, Windows and self-hosted.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows, self-hosted
- **Repository:** https://github.com/jangtrinh/design-os-3d-blender
- **MCP Registry name:** io.github.jangtrinh/design-os-3d-blender
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media)
- **Listing updated:** 2026-11-18

## About

The README describes this as a way for a coding agent to drive a local Blender 5.2 install, so models, renders and mechanical checks happen on the user's own machine rather than in a hosted service. Parts are specified in millimeters through a spec.json file that is validated before any geometry is generated.

The server exposes four tools: a runtime status check, a search over a bpy 5.2 knowledge base, spec validation, and execution of a headless Blender pass. Each executed pass ends with a single AGENT_OK or AGENT_FAIL line, which the README treats as the verdict rather than the process exit code.

The project is aimed at people who design printable mechanical parts and want an agent to iterate on them with geometry gates for manifold output, wall thickness and bounds. Exports are STL and glTF. The README says it is free and source-available under PolyForm Shield 1.0.0.

## Features

- **Four MCP tools:** Exposes runtime status, Blender knowledge search, spec validation and headless pass execution.
- **Millimeter-locked specs:** Part specs check units, target dimensions, tolerance and minimum wall before modeling runs.
- **Pass verdict line:** Each run returns an explicit AGENT_OK or AGENT_FAIL line for the agent to read.
- **3D-print production gate:** Checks manifold geometry, wall thickness and bounds for printable output.
- **STL and glTF export:** Exports finished models as STL or glTF files.
- **Local execution:** The README states the server does not send data off the user's machine.

## Good for

- Modeling a printable mechanical part from a plain-English request and a spec file
- Checking a Blender model against wall thickness and bounds before printing
- Exporting a finished part as STL for a 3D printer or glTF for a viewer
- Letting a coding agent iterate on Blender geometry inside a gated pipeline

## Tools

- `blender_runtime_status`: Reports host, Python and whether a Blender 5.2 binary is available.
- `query_blender_knowledge`: Searches the bpy 5.2 knowledge base before writing a script.
- `validate_part_spec`: Checks a spec.json for units, target dimensions, tolerance and minimum wall.
- `execute_blender_pass`: Runs a headless Blender pass and returns an AGENT_OK or AGENT_FAIL line.

## FAQ

### What does the server need to run?

The README says it needs a Blender 5.2 binary, set through the BLENDER_BIN environment variable, and Python for installation.

### Which file formats does it export?

The README says exports are STL and glTF.

### What license does it use?

The README says it is free and source-available under PolyForm Shield 1.0.0, which allows use and modification but not resale or building a competing product.

### Is design-os-3d-blender free?

Yes. design-os-3d-blender is open source, so you can use and self-host it for free.

### What are the best alternatives to design-os-3d-blender?

The closest alternatives to design-os-3d-blender are OpenSCAD, mcp-for-blender, Kiln, OwlCAD and b123d-print.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.

## Alternatives

- [OpenSCAD](https://ai-powered.com/mcp/openscad): OpenSCAD is an open-source MCP server for design and media.
- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source MCP server for design and media.
- [Kiln](https://ai-powered.com/mcp/kiln): Kiln is a freemium MCP server for design and media.
- [OwlCAD](https://ai-powered.com/mcp/owlcad): OwlCAD is a freemium MCP server for design and media.
- [b123d-print](https://ai-powered.com/mcp/b123d-print): b123d-print is an MCP server for design and media.
- [Quady3D MCP](https://ai-powered.com/mcp/quady3d-mcp): Quady3D MCP is a freemium MCP server for design and media.
- [3D New Era AI](https://ai-powered.com/mcp/3d-new-era-ai): 3D New Era AI is an open-source MCP server for design and media.
- [Lambdacad MCP](https://ai-powered.com/mcp/lambdacad-mcp): Lambdacad MCP is an open-source MCP server for design and media.

---
Source: https://ai-powered.com/mcp/design-os-3d-blender
