This project provides a Model Context Protocol (MCP) server for FreeCAD, enabling control of the CAD software via Claude Desktop. It targets users who want to leverage AI assistants for parametric design tasks, offering a bridge between natural language instructions and FreeCAD's modeling capabilities.

How It Works

The server acts as an intermediary, translating commands from Claude Desktop into FreeCAD's Python API. It exposes a set of tools for document creation, object manipulation, code execution, and retrieving model information, facilitating AI-driven design workflows.

Quick Start & Requirements

• Install addon: Copy the addon/FreeCADMCP directory to your FreeCAD addons path (e.g., ~/.FreeCAD/Mod/).
• Restart FreeCAD and select "MCP Addon" from the Workbench list.
• Start the RPC server via the "Start RPC Server" command in the "FreeCAD MCP" toolbar.
• Claude Desktop requires uvx and a configured claude_desktop_config.json file.
• See official documentation for detailed setup.

Highlighted Details

• Enables AI-driven parametric CAD design.
• Supports common modeling operations: create/edit/delete objects, execute Python code.
• Allows retrieval of model data and screenshots.
• Integrates with Claude Desktop for natural language interaction.

Maintenance & Community

The project lists contributors via contrib.rocks. Further community or roadmap information is not readily available in the README.

Licensing & Compatibility

The repository does not explicitly state a license. Compatibility for commercial use or closed-source linking is not specified.

Limitations & Caveats

The project appears to be in an early stage, with limited details on stability, error handling, or comprehensive feature coverage. The dependency on uvx and specific Claude Desktop configuration might present adoption hurdles.