Render LDraw/LEGO models to images with real part geometry via headless Blender + ImportLDraw
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Not yet automatically verified
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Documentation Overview
ldraw-mcp
Give your MCP client eyes for LEGO® models.
Render LDraw files (.ldr / .mpd / .dat) to images with real part
geometry — studs, slopes, window glass — using headless Blender and the
ImportLDraw addon. The output looks like a BrickLink Stud.io render, with no
GUI anywhere in the loop.
A ~90-line .ldr rendered front-left and rear-right — actual bricks, not a geometric proxy.
Point a vision-capable model at a build and it sees the actual bricks: crossed rotation matrices, floating plates, sunken windows — the kinds of export bugs a geometric proxy render will happily hide.
Quickstart
Then ask things like "render output/build.ldr and tell me what looks wrong" — the model sees the render, not just the text.
Blender is a prerequisite (see Requirements); it is not installed by
ldraw-mcp-setup.
Tools
| tool | what it does |
|---|---|
render_ldraw_file(path, azimuths="-60,120", resolution=640, samples=24) | Render a model file to a PNG (multi-view, stitched side by side) |
render_ldraw_text(ldr, azimuths="-60,120", resolution=640, samples=24) | Render inline LDraw content without writing a file first |
check_renderer() | Diagnose the Blender / addon / parts-library setup |
azimuths is a comma-separated list of view angles in degrees; each is
rendered and the views are stitched horizontally. Elevation is fixed at
22°. Higher samples = cleaner but slower.
Requirements
- Blender 4.x on
PATH, or pointLDRAW_MCP_BLENDERat the binary. Install it yourself (package manager, blender.org, or a local build);ldraw-mcp-setupdoes not install Blender. - ImportLDraw addon (
io_scene_importldraw) in Blender's addons dir — installed byldraw-mcp-setup. - LDraw parts library at
~/.ldraw(orLDRAW_LIBRARY_PATH) — installed byldraw-mcp-setup.
Environment variables
| var | meaning |
|---|---|
LDRAW_MCP_BLENDER | Path to the blender binary (overrides PATH lookup) |
LDRAW_MCP_DISABLE | Set to 1 to force is_available() to False |
LDRAW_LIBRARY_PATH | Path to the LDraw parts library (community convention) |
Manual setup
If ldraw-mcp-setup can't detect things automatically:
- LDraw library: download
complete.zip
and unzip so that
~/.ldraw/parts/exists. - ImportLDraw addon: download the latest release from
TobyLobster/ImportLDraw
and install it via Blender > Preferences > Add-ons > Install, or unzip
into
~/.config/blender/<version>/scripts/addons/io_scene_importldraw/. (Launch Blender once first so the config directory exists.)
Troubleshooting
check_renderersays NOT FOUND: runldraw-mcp-setup, or set the relevant env var above.- No GPU / WSL2 / containers: rendering uses Cycles on CPU, which works headless everywhere — no GPU or display needed. A ~150-part model takes a few seconds at the default 640px / 24 samples.
- "no mesh objects imported": the addon couldn't resolve parts —
usually a wrong or incomplete LDraw library path. Re-run setup or check
LDRAW_LIBRARY_PATH. - Addon not enabled: the render script enables it automatically per
run; if a manual Blender session complains, enable
io_scene_importldrawin Preferences > Add-ons.
Provenance
This renderer was extracted from the prompt2brick project, where it started life as the vision critic's "see the actual model" path. prompt2brick keeps its own vendored copy of the render wrapper and Blender script, but this repo is the canonical source going forward — fixes and improvements to the renderer should land here first and be ported back into prompt2brick.
License
MIT — see LICENSE.
LEGO® is a trademark of the LEGO Group, which does not sponsor, authorize, or endorse this project. This tool is not affiliated with the LEGO Group, BrickLink, or the LDraw.org organization.
Related MCP Servers
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Ldraw MCP
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/ldraw-mcp)HTML Embed
<a href="https://allmcps.com/mcp/ldraw-mcp"><img src="https://allmcps.com/api/badge/ldraw-mcp?style=directory" alt="Ldraw MCP on AllMCPs" /></a>Technical Specs & Signals
CategoryDeveloper Tools
37Quality signal: Fair · 37/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools16/30
Adoption & activity2/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.