Chamfer
Chamfer
An independent, open-source millimeter CAD workbench, deterministic geometry and specification verifier, and 2D-to-3D solid manufacturing bridge started by Hasan Yahşi under Aeonavis.
Long-term direction: a local-first AutoCAD-class drafting and solid-modeling tool with exact millimeter workflows, deterministic manufacturing verification, interoperable DXF/STEP files, and commercial freedom without mandatory cloud subscriptions.
Live zero-install browser workbench: Open 2D CAD · Interactive DRC Repair Demo (?preset=fault)

Implemented in 0.3.0a1:
Zero-Install Browser Workbench & Local Python Bridge: The static bundle in
web/distopens directly into the 2D millimeter CAD workbench at/(and/?preset=fault) on any standard static file host without requiring a backend: client-side R2010 millimeter ASCII DXF import/export (LINE,LWPOLYLINE,CIRCLE,ARC,DIMENSION,TEXTwith non-plottingCONSTRUCTIONlayer preservation), manufacturing-DRC-stamped ISO.svgblueprint export, and interactive DRC repair preview (emerald ghost geometry + millimeter coordinate diffs). Whenchamfer-serve(127.0.0.1:4310) is running locally, live workspace sync, synthesis, and Open CASCADE 3D B-Rep extrusion activate automatically.2D Millimeter Drafting Engine (Twin Python + JS Parity): Command-driven planar CAD (
LINE,PLINE,RECTANG,CIRCLE,ARC,OFFSET,CHAMFER,FILLET,TRIM,ROTATE,MIRROR,ARRAY,DIM,TEXT,MOVE,COPY,ERASE,DIST,LINT,UNDO,REDO,LAYERincludingCONSTRUCTIONreference layers), instantEN / TRworkstation toggle, AutoCAD-style object snaps (END,MID,CEN,QUAD,INT,PER), analytical window/crossing selection, and standard mechanical presets (NEMA-17,ISO DN50,EIA 19" 1U).Analytical Topology & Manufacturing Verifier (
DRC): Order-independent planarLINE + ARCcycle chaining (1e-4 mmshared tolerance), analytical Green's theorem contour areas, curve-aware ray-casting interior predicates and exact quadratic/circle-circle curve intersections (including non-concentricARC-ARCcrossings and clearances — no polygon chord sampling), cross-layer collision checks, T-junction/self-intersection rejection, and explicit single-part manufacturing gates (MULTIPLE_OUTER_PROFILES,NESTED_ISLAND_UNSUPPORTED).2D-to-3D Open CASCADE Solid Bridge (
STEP / STL) & CAM Telemetry: Extrudes verified single-part 2D profiles into Open CASCADE (build123d) 3D B-Rep solids, enforces positive manifold volume, top-face inner-wire topology, and 2D-vs-3D volume & surface-area invariants, renders an interactive orthographic 3D turntable preview, exports.step/.stl, and computes cut length, pierce count, scrap ratio, and Aluminum 6061 / Steel S235 mass.Transactional Synthesis, Typed Feature Verification & MCP Server (
chamfer-mcp): Candidate-first validation on/api/drawing/stateand/api/drawing/exec(rejected payloads never mutate active document or revision), bounded JSON nesting depth (max_depth=64), optimistic concurrency (expected_revisionCAS +request_ididempotency), strictstdioMCP commit uncertainty reporting (post-connect transport drops raise explicit errors instead of silently falling back to an isolated local session), loopback discovery for local runtimes (Ollama,LM Studio,llama.cpp), and an offline parametric rule compiler verified against requested envelope, hole radii, obround slot capsules, flangeOD/ID/PCDbolt circles, and corner chamfers/fillets before touching the active document.


Quick start (local workbench)
Python 3.12 and Node.js 24 are required. On Windows PowerShell:
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.lock
.\.venv\Scripts\python.exe -m pip install --no-deps -e .
npm --prefix web ci
npm --prefix web run build
.\.venv\Scripts\chamfer-serve.exe --port 4310Linux/macOS use .venv/bin/python and .venv/bin/chamfer-serve. Open
http://127.0.0.1:4310 (or http://127.0.0.1:4310/?preset=fault to inspect a defective
CNC bracket, preview the proposed millimeter coordinate repairs on canvas, apply them, and
export verified DXF / STEP files). The static bundle in web/dist also runs all 2D drafting,
DRC preview-repair, CAM metrics, DXF import/export, and SVG blueprint export without a backend.
Standard engineering examples in examples/:
NEMA-17 stepper motor mount (
42.3 × 42.3 mm,4×M3on31.0 mmcenters,Ø22 mmpilot bore,3 mmchamfered corners)ISO DN50 PN16 pipe flange (
Ø165 mmOD,Ø60.3 mmbore, polar bolt circle)EIA-310 19-inch 1U rack panel (
482.6 × 44.45 mmwith slotted mounting ears)Layered office layout (
CONSTRUCTIONand drafting layers on a10 × 7 mmillimeter grid)
Related MCP server: TianshangCAD
Spatial verification suite & DRC benchmarks
Run the multi-gate spatial verification suite (36 positive rule-compiler & DSL parts across 6
mechanical families checked for manufacturing DRC, Python↔JS parity, R2010 DXF round-trip,
raw-JSON feature compliance, and Open CASCADE .step serialization round-trip volume + 3D surface
area + bounding box; 15 curated adversarial & specification-tampering traps; and 6
deterministic DRC preview-repairs). Note: default mode evaluates the offline deterministic rule
compiler (parametric:chamfer-rule-v1), not open-ended LLM spatial reasoning, and .step
re-import validates serialization consistency within Open CASCADE rather than a separate CAD
kernel; pass --runtime <id> to benchmark an external runtime:
.\.venv\Scripts\python.exe benchmarks/spatial_eval.pyRun the 12-pair static DRC fault-recall and reference B-Rep fixture check, or lint any
.cadlab.json file from the CLI:
.\.venv\Scripts\python.exe benchmarks/drc_benchmark.py
.\.venv\Scripts\chamfer.exe --lint-drawing examples/nema17-motor-mount.cadlab.jsonProgrammatic CAD & MCP integration (chamfer-mcp)
Install the reusable CAD drafting and manufacturing verification skill (skills/chamfer/SKILL.md; repository guidelines in AGENTS.md):
npx skills add hasanyahsitr/chamferchamfer-mcp runs over standard stdio JSON-RPC 2.0 (2025-03-26 / 2024-11-05):
{
"mcpServers": {
"chamfer": {
"command": "chamfer-mcp",
"args": ["--port", "4310"]
}
}
}Available MCP tools:
chamfer_get_drawing— read active layers, entities, revision, and verification summarychamfer_execute— run atomic millimeter CAD command batches (NEW,LAYER,RECTANG,PLINE,LINE,CIRCLE,ARC,OFFSET,CHAMFER,FILLET,TRIM,ROTATE,MIRROR,ARRAY,DIM,TEXT,SELECT,MOVE,COPY,ERASE,UNDO,REDO)chamfer_modify_entity— surgically update entity coordinates, radii, layer, or closed loop state by ID (reporting explicit snap/closure deltas)chamfer_lint— run manufacturing or drafting DRC checkschamfer_cam_report— compute analytical net area, cut length, pierce count, scrap ratio, and part masschamfer_extrude_3d— extrude verified single-part 2D profiles into Open CASCADE.step/.stl3D solids (overwrite=falseby default)chamfer_export_dxf/chamfer_import_dxf— verified ASCII R2010 millimeter DXF interchange
Local HTTP endpoints served by chamfer-serve: /api/drawing/state (supports expected_revision
CAS and request_id idempotency), /api/drawing/exec, /api/drawing/lint, /api/drawing/dxf,
/api/drawing/import-dxf, /api/drawing/svg, /api/drawing/cam, /api/drawing/extrude,
/api/drawing/runtime, and /api/drawing/synthesize.
Automated checks
.\.venv\Scripts\python.exe -m pytest -q
.\.venv\Scripts\python.exe -m ruff check src tests benchmarks
.\.venv\Scripts\python.exe -m ruff format --check src tests benchmarks
npm --prefix web test
npm --prefix web run format:check
npm --prefix web run buildExplicit scope & current limits
Chamfer 0.3.0a1 targets single-part planar XY 2D profiles extruded to single-thickness
prismatic 3D solids (sheet-metal brackets, laser/waterjet plates, CNC mounts, pipe flanges,
and rack panels). Rather than silently approximating unsupported geometry, Chamfer rejects out-of-scope inputs explicitly:
Disjoint multi-part sheets (
MULTIPLE_OUTER_PROFILES) and nested islands inside cutouts (NESTED_ISLAND_UNSUPPORTED) are rejected in manufacturing DRC and 3D extrusion.DXF
LWPOLYLINEbulge/widths,SPLINE,ELLIPSE,BLOCK/INSERT, paper-space entities, non-millimeter units, and rotated/projectedDIMENSIONsubtypes whose measurement differs from aligned span are rejected cleanly without mutating the active drawing.Interactive geometric sketch constraint solving, multi-feature 3D history trees, assemblies, G-code post-processing, 3D sheet-metal bend unfolding, and proprietary DWG files are not implemented yet. Tracked items live on the roadmap.
Documentation
License
Original code is MIT-licensed. Dependencies retain their upstream licenses; in particular, Open CASCADE is LGPL-2.1 with an additional exception.
Available Tools
8 toolschamfer_cam_reportA
Compute laser/CNC manufacturing telemetry for the active 2D drawing: total cutting path length (mm), pierce count, net part area (mm2), scrap percentage, and sheet mass.
Inputs: thickness_mm.
chamfer_executeA
Execute deterministic 2D CAD drafting commands in millimeters atomically and run manufacturing/geometry verification. Supported commands: NEW [name], LAYER [#hex] [CONSTRUCTION], RECTANG <x1,y1> <x2,y2> [id=...], PLINE [... C] [id=...], LINE [...] [id=...], CIRCLE <cx,cy> [D] <r_or_d> [id=...], ARC [id=...] (or ARC C <cx,cy> <start_deg> <end_deg>), OFFSET [entity_id] <side_x,y> [id=...], CHAMFER, FILLET, TRIM, ROTATE, MIRROR, ARRAY, TEXT, DIM <dim_pt> [id=...], SELECT <ALL|NONE|ids>, MOVE , COPY , ERASE [ids], UNDO, REDO.
Inputs: commands (required).
chamfer_export_dxfA
Export the verified 2D drawing to ASCII R2010 millimeter DXF. Optionally write the output to a local .dxf file path (refuses to overwrite unless overwrite=true).
Inputs: overwrite, output_path.
chamfer_extrude_3dA
Extrude the active single-part planar 2D drawing into an exact Open CASCADE 3D B-Rep solid and optionally save STEP or STL to disk.
Inputs: format, overwrite, output_path, thickness_mm.
chamfer_get_drawingA
Read the active millimeter 2D CAD drawing state (layers, entities, revision) and its deterministic geometry verification summary.
Inputs: no named parameters.
chamfer_import_dxfB
Import planar millimeter ASCII DXF text into the active workspace.
Inputs: dxf (required).
chamfer_lintB
Run deterministic 2D geometry and CNC/manufacturing checks (open contour gaps, self-intersections, duplicate cuts, hole-edge collisions, thin webs, stray holes).
Inputs: max_gap_mm, manufacturing, min_segment_mm, min_clearance_mm.
chamfer_modify_entityA
Update an existing entity's properties by ID (center, radius, points, closed, layer) and re-verify geometry. Use this to fix open contours or clearance collisions.
Inputs: id (required), layer, center, closed, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Most tools have clear distinct roles across drafting, modification, linting, import/export, CAM reporting, and 3D extrusion. However, chamfer_execute is a broad catch-all that includes editing operations overlapping with chamfer_modify_entity, and verification appears in get_drawing, execute, and lint, creating some potential misselection.
All tool names use a consistent chamfer_ prefix and snake_case formatting. The pattern is mostly verb_noun, but a few names deviate as bare verbs (execute, lint) or noun phrases (cam_report), preventing a perfect score.
Eight tools are well-scoped for a 2D CAD/CAM server, covering state access, command execution, entity modification, validation, DXF I/O, manufacturing telemetry, and 3D extrusion. Each tool has a clear reason to exist without excessive granularity.
The surface covers the full lifecycle: read state, execute drawing commands, modify entities, import/export DXF, lint geometry and manufacturing issues, compute CAM metrics, and extrude to 3D. No obvious gaps remain for the stated CAD/CAM domain.
Maintenance
Related MCP Connectors
Headless CAD engine & MCP server for 2D/3D drafting, solids, DXF/SVG export, and automation.
Parametric CAD as code: model 3D-printable parts on an exact B-rep kernel, measured.
Fast multi-format CAD previews, geometry checks and conversion; measure and share in the workspace.
Text-to-CAD: build exact STEP or 3MF/STL on the server, each stated requirement measured.
Related MCP Servers
- FlicenseAqualityBmaintenanceCAD-engineering MCP tool server for parametric modeling, DFM validation, mechanical calculations, and more. Enables code-CAD builds (build123d/CadQuery), model inspection, meshing, and mechanical calculators via MCP stdio.11-
- AlicenseAqualityCmaintenanceModern CAD CLI + MCP Server: 2D/3D drawing, editing, measurement, validation, batch automation, real-time collaboration (CRDT + WebSocket).222Apache 2.0
- AlicenseBqualityDmaintenanceMCP server that lets AI draw in AutoLISP-capable CAD (reference BricsCAD on Linux) via a file bridge, enabling 2D drafting, 3D solid modeling, and verification with 100 tools.1283Apache 2.0
- AlicenseNot gradedqualityDmaintenanceMCP server for AI-driven CAD operations, enabling parametric modeling, build, inspection, measurement, rendering, and diff comparison with STEP, DXF, and GLB export.MIT