Skip to main content
Glama
formastep-mcp
by eldertek

formastep

Clean-room open-source parametric 3D CAD engine, local offline CAD & DFM Web Studio, ISO 10303-21 STEP inspector/exporter, DFM manufacturability auditor, and Model Context Protocol (MCP) server.

formastep compiles parametric solids from strict declarative JSON (PartSpec), verifies manifold topology, exports STEP / 3MF / STL / 3-view orthographic SVG drawings, and runs automated Design for Manufacturing (DFM) checks from the GUI (formastep ui), CLI, or MCP server with zero proprietary licenses or cloud lock-in.

Live browser demo: https://eclipse-technology.eu/demos/formastep/

formastep CAD & DFM Studio

Documentation

Related MCP server: kernelCAD

Why formastep

Commercial CAD suites charge $299/yr to $2,820+/yr per seat and gate STEP export or headless batch automation behind proprietary desktop licenses. formastep gives hardware engineers and automated manufacturing pipelines a deterministic, MIT-licensed toolchain:

  • Zero arbitrary code execution: declarative Pydantic v2 PartSpec schema with an explicit AST arithmetic evaluator for named parameters (zero eval, zero exec).

  • Offline SolidWorks/CATIA-Style CAD & DFM Workstation (formastep ui): local loopback GUI (127.0.0.1:8743) or standalone desktop window (--desktop / formastep-desktop) with CommandManager ribbon, FeatureManager Design Tree, PropertyManager, interactive 3D viewport (Shaded+Edges, Shaded, Hidden Lines, Wireframe, CATIA Blue backdrop), ISO 3-view blueprints, 1-click exports, STEP validator, and EN/FR interface.

  • Guaranteed-manifold CSG compilation: uses manifold3d and trimesh for exact boolean union/difference/intersection, fillets, chamfers, extruded 2D profiles with holes, revolutions, countersunk holes, and linear/circular patterns.

  • Clean-room ISO 10303-21 STEP: built-in STEP AP214/AP203 parser and referential-integrity validator (step_inspect), plus a deterministic AP214 FACETED_BREP writer.

  • Automated DFM QA & BOM: checks watertightness, 2-manifold topology, Euler/genus, ray-cast minimum wall thickness, build-plate overhang angles, sharp internal corners, hole aspect ratios, injection draft angles, and emits a structured BOM JSON.

  • Deterministic 3-view engineering drawings: pure vector orthographic SVG sheets (TOP (XY), FRONT (XZ), RIGHT (YZ)) with silhouette and crease edge extraction.

  • Native MCP Server: exposes typed tools (part_build, step_inspect, dfm_audit, view_render_svg, export_manufacturing_bundle) over stdio with workspace path confinement.

Requirements

  • Python 3.10+

Installation

git clone https://github.com/eldertek/formastep.git
cd formastep
pip install -e ".[dev]"

Quickstart CAD Workstation

Launch the offline SolidWorks/CATIA-style CAD & DFM Workstation (127.0.0.1:8743):

formastep ui
# Or launch in a standalone desktop application window:
formastep ui --desktop
formastep-desktop --workspace-dir ./parts
# Or use the dedicated web-UI entrypoint:
formastep-ui --workspace-dir ./parts

Use --port 0 --no-open to bind an ephemeral port without launching a browser tab automatically. See the GUI Studio Guide for a full walkthrough, or try the live web demo at https://eclipse-technology.eu/demos/formastep/.

Quickstart CLI

Check installed geometry backends:

formastep doctor

Save a parametric mounting flange (flange.json):

{
  "schema_version": "1.0",
  "name": "motor_flange_v1",
  "units": "mm",
  "parameters": {
    "outer_d": 60.0,
    "bore_d": 22.0,
    "thickness": 8.0,
    "bolt_circle_r": 21.0
  },
  "material": {
    "name": "PETG-CF",
    "density_g_cm3": 1.32,
    "process": "fdm"
  },
  "root": {
    "kind": "cylinder",
    "diameter": "outer_d",
    "height": "thickness",
    "center": true
  },
  "features": [
    {
      "kind": "hole",
      "diameter": "bore_d",
      "position": [0, 0, 0],
      "axis": "z"
    },
    {
      "kind": "cut",
      "node": {
        "kind": "circular_pattern",
        "count": 4,
        "axis": "z",
        "radius": "bolt_circle_r",
        "child": {
          "kind": "hole",
          "diameter": 4.5,
          "countersink_diameter": 8.2,
          "depth": "thickness + 2"
        }
      }
    }
  ]
}

Compile and export the full manufacturing bundle (STEP, 3MF, Binary STL, 3-view SVG, DFM JSON, BOM JSON, and SHA-256 manifest):

formastep bundle flange.json --out-dir ./bundle

Other CLI commands:

formastep build flange.json --out-dir ./out --formats step,3mf,stl,svg
formastep inspect-step ./out/motor_flange_v1.step
formastep dfm flange.json --process fdm --min-wall-mm 1.2
formastep render-svg flange.json --output ./out/motor_flange_v1.svg

MCP Server

Start the server on stdio:

formastep-mcp
# or
formastep mcp-serve

Set FORMASTEP_WORKSPACE_ROOT to confine all file reads and artifact writes to a specific directory (defaults to the current working directory).

Exposed MCP tools:

  • part_build: Compile PartSpec and write step, 3mf, stl, stl_ascii, svg.

  • step_inspect: Parse and validate an ISO 10303-21 .step/.stp file (schema, entities, units, bounding box, duplicate IDs, dangling references).

  • dfm_audit: Run watertightness, manifoldness, ray-cast wall thickness, overhang/draft, and BOM audit on a PartSpec or .stl/.3mf file.

  • view_render_svg: Generate deterministic 3-view orthographic SVG output.

  • export_manufacturing_bundle: End-to-end build, STEP verification, DFM audit, and SHA-256 manifest export.

v0.1 Scope and Known Limitations

  • Default STEP output uses deterministic ISO 10303-21 AP214 FACETED_BREP (triangulated closed manifold shells), not analytical NURBS surfaces; optional B-Rep tooling is declared under the [brep] extra (build123d).

  • PartSpec targets single-part parametric geometry; multi-part assemblies, mates, and kinematic constraints are not implemented in v0.1.

  • Minimum wall-thickness checks rely on mesh ray-casting and depend on cylinder/arc tessellation resolution.

Development & Tests

ruff check src tests
pytest -v

Commercial Support & Custom Pipelines

Need headless CAD automation, custom DFM checks, or STEP/ERP integration? See Eclipse Technology Open Source Pro.

License

MIT License. See LICENSE.

Available Tools

5 tools
dfm_auditC
Read-onlyIdempotent

Run DFM QA checks (watertightness, wall thickness, overhangs, BOM) on a PartSpec or mesh file.

Inputs: spec, process, mesh_path, min_wall_mm, +1 more. Returns: object

export_manufacturing_bundleB
Idempotent

Compile PartSpec, validate STEP + DFM, and export a full manufacturing bundle with SHA-256 manifest.

Inputs: spec (required), process, output_dir. Returns: object

part_buildC
Idempotent

Compile a parametric PartSpec JSON dict and export STEP/3MF/STL/SVG artifacts.

Inputs: spec (required), formats, output_dir. Returns: object

step_inspectB
Read-onlyIdempotent

Inspect and validate an ISO 10303-21 STEP (.step/.stp) file.

Inputs: file_path (required). Returns: object

view_render_svgB
Idempotent

Render a deterministic 3-view orthographic SVG (Top/Front/Right) from a PartSpec or mesh.

Inputs: spec, mesh_path, output_path. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 5 tools

    Disambiguation3/5

    part_build and export_manufacturing_bundle substantially overlap, since both compile a PartSpec and export artifacts, with the bundle tool just chaining validation and DFM on top. step_inspect and dfm_audit also both perform validation-style checks, making the boundary between 'inspect' and 'audit' unclear. The descriptions help somewhat, but an agent could plausibly pick the wrong one for a simple export request.

    Naming Consistency3/5

    All names are snake_case, but the word order convention is mixed: part_build, step_inspect, and dfm_audit lead with a noun, while view_render_svg and export_manufacturing_bundle lead with a verb. Readable individually, but there is no predictable pattern an agent can rely on to guess a tool name.

    Tool Count4/5

    Five tools is a tight, well-scoped set for a parametric CAD pipeline covering build, inspect, audit, render, and package. It is on the lean side, with the bundle tool arguably absorbing part_build's role, but nothing feels gratuitous.

    Completeness4/5

    The surface covers the core lifecycle: author a PartSpec, validate the resulting STEP, run DFM checks, visualize, and export a manifest bundle. Gaps exist around editing or mutating an existing PartSpec and around converting an existing STEP/mesh back into a PartSpec, which an agent might reasonably expect.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      B
      maintenance
      CAD-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
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables agent-driven CAD design through deterministic source files (.kcad.ts), including model evaluation, validation, and export to STEP/STL via MCP tools for review and introspection.
      75 npm
      35
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables offline-first industrial manufacturing workflows by parsing, linting, and drafting FANUC .LS robot programs and analyzing STEP/STP CAD files through MCP tools.
      4
      Apache 2.0
    • A
      license
      A
      quality
      B
      maintenance
      Enables generating parametric 3D-printable parts from OpenSCAD/CadQuery models, exporting STL/3MF files, running DFM checks, and retrieving Bambu X1 Carbon starting profile notes.
      8
      MIT