freecad

This MCP server exposes FreeCAD functionality to AI assistants through the Model Context Protocol. It enables programmatic creation and manipulation of 3D geometry, supports basic boolean operations, document management, and the ability to run arbitrary Python scripts within FreeCAD's context. You can drive the server from an MCP client to generate geometry by issuing structured commands such as create_box, create_cylinder, create_sphere, and boolean_operation, then save or inspect the resulting document. The available tools support parametric design and assembly-style workflows, allowing you to build complex models by composing simple primitives and applying operations like union, cut, or common between objects. You can also execute custom Python scripts to perform specialized tasks directly inside FreeCAD before finalizing and saving your work. The server is cross-platform and designed to work with Claude and other MCP-enabled assistants that can generate and refine 3D models through natural language or structured prompts.

Prerequisites:

• FreeCAD must be installed on the host machine (freecad.org).
• Node.js (v18 or higher).
• TypeScript for development.

Install and build:

1. Clone the repository:

git clone https://github.com/lucygoodchild/freecad-mcp-server.git
cd freecad-mcp-server

2. Install dependencies:

npm install

3. Build the project:

npm run build

4. Ensure FreeCAD path detection works or configure manually (optional):

• The server attempts to auto-detect FreeCAD installation.
• Default paths (example):
  • Windows: C:\Program Files\FreeCAD 0.21\bin\FreeCAD.exe
  • macOS: /Applications/FreeCAD.app/Contents/MacOS/FreeCAD
  • Linux: /usr/bin/freecad

Tips:

• If FreeCAD is not found, set the freecadPath in the server constructor or environment to the executable path.
• When using execute_python_script, ensure the script is compatible with FreeCAD's Python environment and has access to the current document (e.g., doc refers to the active document).
• Use list_objects to verify object names before performing boolean operations to avoid errors.
• For Claude or other MCP clients, ensure the client configuration points to the correct node command and entry file (build/index.js).
• Check file write permissions when saving documents to a specific path.
• If you run into permission issues on Linux/macOS, ensure the FreeCAD binary and Node process have execution permissions and that the user has access to the FreeCAD installation.