FreeCAD_MCP

ajignasu/FreeCAD_MCP

3.1

If you are the rightful owner of FreeCAD_MCP and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

FreeCAD_MCP is a minimal CAD Model Context Protocol server leveraging FreeCAD for 3D modeling tasks.

FreeCAD_MCP

A minimal CAD MCP server based on FreeCAD

Current Features

  • Multiplane sketching: create sketch planes in XY, XZ, YZ orientations
  • Rectangle sketch creation on the active sketch plane
  • Extrude sketches into 3D shapes along the normal of the sketch plane
  • Fillet edges on extruded shapes
  • Export the current document to a STEP file
  • Status checker that provides information about the current document and its shapes

Setup

git clone https://github.com/ajignasu/FreeCAD_MCP.git
cd FreeCAD_MCP

python -m venv venv
venv\Scripts\activate.bat      # On Windows

pip install -r requirements.txt

Assuming you have nodejs installed, install MCP Inspector globally:

npm install -g @modelcontextprotocol/inspector

Quick Start Example using MCP Inspector

  1. cd into FreeCAD_MCP directory and run venv\Scripts\activate.bat to activate the virtual environments
  2. Start the Inspector UI
npx @modelcontextprotocol/inspector
  1. In the UI, make sure the following fields are set:
Command: YOUR_PATH_TO_FREECAD\bin\python.exe
Arguments: server.py

  1. Click on "Connect"

  2. You should see the following: MCP Inspector Screenshot

  3. Click on "List Tools" to view available tools and test them by entering their required parameters and clicking on "Run Tool"

  4. Outputs will be returned in the "History" tab