sandraschi/freecad-mcp

just bootstrap && start.ps1

Usage

• •Connect any MCP client with url http://localhost:10944/sse (transport sse) and ask the agent to convert STEP files, design rooms, run fluid simulations or slice STL for printing.
• •Drive the same REST API (http://localhost:10944/api/v1/control/tool) directly from Python/curl for headless pipelines and parametric sweeps.
• •For fluid simulation choose OpenFOAM (CPU/Docker, turbulence, multiphase) or FluidX3D (GPU/OpenCL, fast uniform-grid iteration), or describe a flow problem in English and let an LLM write the config.
• •Run FEM with run_fem_analysis (CalculiX + Gmsh meshing, 10 material presets) and export point clouds to train surrogate models.

Key features

• ✓46 MCP tools spanning geometry conversion, architecture/BIM (walls, slabs, columns, windows, doors, roofs, IFC import/export), FEM, CFD, slicing and marketplace search.
• ✓Persistent CAD file depot with full CRUD for managing parts and test brackets.
• ✓Fleet integration: QCAD DXF → FreeCAD → OpenFOAM/FluidX3D → Resonite/Godot/robotics handoff.
• ✓Natural-language CFD config (NL2FOAM) and PINN sampling data export for ML.
• ✓Tauri 2.0 + PyInstaller native desktop build option.

Best for

Engineers and makers who want an AI agent to run CAD conversion, simulation and slicing chains on FreeCAD, with a browser dashboard for humans on the same backend.

Caveats

• ⚠Depends on heavy external tools: FreeCAD 1.1.1+, OpenFOAM 10 via Docker, FluidX3D via OpenCL (GPU), PrusaSlicer 2.8+, Ollama for local LLM.
• ⚠Quick Start is Windows-oriented (start.ps1); ports are fixed at 10944/10945/10946.
• ⚠MIT licensed.