aiblueprint-mcp
thebossnow/aiblueprint-mcp
MCP server for headless DXF generation via ezdxf + LibreCAD preview — purpose-built for site plans and architectural drafting
Instalação
npx convez-ai thebossnow/aiblueprint-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
AIBlueprint MCP
MCP server for headless DXF generation via ezdxf + LibreCAD preview — purpose-built for site plans, architectural drafting, and pool bid layouts.
Built on the ezdxf backend architecture from autocad-mcp (MIT), extended with offset, fillet, dimension overrides, solid fills, and LibreCAD integration. No AutoCAD required — runs on Linux, macOS, WSL, or a Chromebook.
Why This Exists
AutoCAD MCP servers exist, but they require Windows and an AutoCAD license ($600+/year). LibreCAD is free and open-source, but has no scripting API — its "API" is the DXF file format.
AIBlueprint bridges the gap: an MCP server that generates DXF via ezdxf, renders previews through LibreCAD's dxf2png, and exposes the same tool interface LLMs already know from autocad-mcp — all at $0 in software costs.
Quick Start
git clone https://github.com/thebossnow/aiblueprint-mcp.git
cd aiblueprint-mcp
uv sync
uv run aiblueprint-mcp
Configure LibreCAD (for previews)
# Set path to your librecad binary (required for previews)
export AIBLUEPRINT_LIBRECAD_BIN=/path/to/librecad
# Optional: working directory for preview renders
export AIBLUEPRINT_WORKSPACE=/path/to/workspace
Don't have LibreCAD? The server works without it — you just won't get PNG previews. Build from source or install via your package manager (sudo apt install librecad on Debian/Ubuntu).
MCP Client Configuration
Add to your MCP client (Claude Desktop, Hermes, etc.):
{
"mcpServers": {
"aiblueprint-mcp": {
"command": "uv",
"args": ["run", "--directory", "/path/to/aiblueprint-mcp", "aiblueprint-mcp"],
"env": {
"AIBLUEPRINT_LIBRECAD_BIN": "/path/to/librecad",
"AIBLUEPRINT_WORKSPACE": "/path/to/workspace"
}
}
}
}
Tools
drawing — File + Session Management
| Operation | Description | Data |
|---|---|---|
create | New empty drawing — returns a handle | {name?} |
open | Open existing DXF (within workspace) | {path} |
info | Layers, entity count, blocks | — |
save | Save to path (within workspace) | {path?} |
list | List all open drawings in the session | — |
switch | Make another open drawing current | {handle} |
undo | Revert the current drawing to the previous checkpoint | — |
redo | Re-apply the most recently undone checkpoint | — |
Multiple drawings can be open at once. Each create/open returns a handle;
use switch to change which drawing subsequent operations target. File paths
for open/save are confined to AIBLUEPRINT_WORKSPACE — traversal outside it
(../, absolute escapes) is rejected.
entity — Entity CRUD + Modification
Create:
| Operation | Parameters |
|---|---|
create_line | x1, y1, x2, y2, layer? |
create_circle | data: {cx, cy, radius}, layer? |
create_polyline | points: [[x,y],...], data: {closed?}, layer? |
create_rectangle | x1, y1, x2, y2, layer? |
create_arc | data: {cx, cy, radius, start_angle, end_angle}, layer? |
create_text | data: {x, y, text, height?, rotation?}, layer? |
create_mtext | data: {x, y, width, text, height?}, layer? |
create_hatch | entity_id, data: {pattern?, scale?} |
import_boundary | ⭐ Irregular parcel boundary. data: {points: [[x,y],...]} or {geojson: {...}}, layer? → returns handle + area/perimeter/bbox |
Read: list (by layer), get (full detail for LINE/CIRCLE/ARC/LWPOLYLINE/TEXT/MTEXT/INSERT/HATCH), measure (area / perimeter / length quantity takeoff by entity_id)
Modify:
| Operation | Notes |
|---|---|
copy / move / rotate / scale / mirror | Standard CAD transforms |
offset | ⭐ Offset polylines (open or closed) — deck bands, setbacks |
fillet | ⭐ Fillet two lines with a radius arc + auto-trim |
array | Rectangular array (rows × cols) |
erase | By entity_id or "last" |
layer — Layer Management
list, create, set_current, set_properties, freeze, thaw, lock, unlock
Named colors: red, yellow, green, cyan, blue, magenta, white, grey, lightgrey. For arbitrary colors, pass true_color: [r, g, b] (0–255) to create or set_properties.
block — Blocks + Attributes
list, insert, insert_with_attributes, get_attributes, update_attribute, define
annotation — Dimensions, Text, Leaders
| Operation | Notes |
|---|---|
create_text | Single-line text with rotation |
create_dimension_aligned | ⭐ With dim_overrides |
create_dimension_linear | ⭐ With dim_overrides |
create_dimension_angular | ⭐ With dim_overrides |
create_dimension_radius | ⭐ With dim_overrides |
create_leader | Leader line + mtext |
Dimension overrides: dimtxt, dimasz, dimlunit, dimclrd, dimclre, dimclrt, dimtxsty
Example:
{
"operation": "create_dimension_aligned",
"data": {
"x1": 0, "y1": 0, "x2": 100, "y2": 0, "offset": -5,
"dim_overrides": {"dimtxt": 1.75, "dimasz": 1.25, "dimlunit": 2}
}
}
view — Previews + Screenshots
| Operation | Description |
|---|---|
preview | Save DXF + render PNG via LibreCAD dxf2png — returns file paths |
screenshot | Render the drawing via matplotlib and return it as a native MCP image (no LibreCAD needed) |
export | Write a PNG/PDF/SVG raster/vector render or a GeoJSON FeatureCollection to the workspace. `data: {format?: "pdf" |
Hatch Patterns
| Pattern | Use |
|---|---|
SOLID | Water features, colored surfaces |
ANSI31 | Single diagonal hatch |
ANSI37 | Dense cross-hatch — hardscape, concrete |
ANSI32 | Wide cross-hatch |
AR-CONC | Concrete texture |
EARTH | Earth/soil fill |
Environment Variables
| Variable | Default | Description |
|---|---|---|
AIBLUEPRINT_LIBRECAD_BIN | Auto-detects from common locations | Path to librecad executable |
AIBLUEPRINT_WORKSPACE | ~/workspace | Working directory for preview renders |
DISPLAY | :0 | X11 display (for WSLg / Linux GUI) |
Python API
You can also use the backend directly without the MCP server:
from aiblueprint_mcp.backend import AIBlueprintBackend
import asyncio
async def main():
b = AIBlueprintBackend()
await b.initialize()
await b.drawing_create("my_plan")
# Draw a 100×80 ft lot with pool deck
await b.create_rectangle(0, 0, 100, 80, layer="LOT")
deck = await b.create_rectangle(10, 20, 50, 60, layer="DECK")
# Offset deck band inward 4 ft
inner = await b.entity_offset(deck.payload["handle"], -4.0)
# Add pool with solid blue fill
pool = await b.create_rectangle(18, 28, 42, 52, layer="POOL")
await b.create_hatch(pool.payload["handle"], "SOLID")
# Cross-hatch the deck
await b.create_hatch(inner.payload["handle"], "ANSI37", scale=12.0)
# Fillet a corner
l1 = await b.create_line(50, 60, 50, 20, layer="DECK")
l2 = await b.create_line(50, 20, 10, 20, layer="DECK")
await b.entity_fillet(l1.payload["handle"], l2.payload["handle"], 8.0)
# Dimension with style overrides
await b.create_dimension_aligned(0, 0, 100, 0, -5,
dim_overrides={"dimtxt": 1.75, "dimasz": 1.25, "dimlunit": 2})
# Save and preview
await b.drawing_save("/tmp/my_plan.dxf")
result = await b.preview()
print(result.payload["png_path"])
asyncio.run(main())
Input Validation
Every tool operation validates its input against a per-operation schema
(Pydantic) before touching the drawing. Missing required fields, wrong types,
out-of-range values (e.g. a negative radius), and unknown fields are rejected
with a clear message — {"ok": false, "error": "Invalid input for entity.create_circle: ..."} — instead of a raw traceback.
Development
uv sync --extra dev # install dev dependencies (pytest, ruff)
uv run pytest -q # run the test suite (134 tests)
uv run ruff check src tests
CI runs lint + tests on Python 3.10–3.12 via GitHub Actions (.github/workflows/ci.yml).
See CHANGELOG.md for release history and RELEASING.md for how releases are cut.
Roadmap / Known Limitations
Tracked in the issue tracker — contributions welcome:
- Docker image bundling LibreCAD (#9)
- Coverage reporting in CI (#10)
- PyPI publication, versioned releases, changelog (#11)
- Jurisdiction data beyond California (#12)
- Live LibreCAD backend via bivex's TCP bridge (#1)
License
MIT — see LICENSE.
This project incorporates architecture and patterns from autocad-mcp by Puran Water LLC, also MIT-licensed. The ezdxf backend, MCP tool dispatch pattern, and command result types are adapted from autocad-mcp v3.1. Entity offset, fillet, dimension overrides, solid fills, and LibreCAD preview are original additions.
Requirements
- Python 3.10+
- uv package manager
- LibreCAD (optional, for PNG previews)
- 0 software licenses — ezdxf is MIT, LibreCAD is GPLv2
Acknowledgments
- Hermes (AI coding agent) — co-author. Designed and implemented entity offset, fillet, dimension overrides, solid fills, and LibreCAD preview integration.
- DeepSeek V4 Pro — the model that powered every line of this project. Fast, precise, never hallucinated a dimension.
- Julian Goldie — for the relentless push to build in public and ship real tools, not just prompts. Join his AI Profit Lab on Skool.
- Puran Water LLC — upstream autocad-mcp project (MIT). The ezdxf backend architecture, MCP tool dispatch pattern, and command result types are adapted from their v3.1 release.
- LibreCAD — the open-source 2D CAD engine that makes $0 drafting possible.