FreeCAD MCP
by neka-nat
This repository provides a FreeCAD MCP (Message Control Protocol) that enables you to control FreeCAD from Claude Desktop. It allows for automated design and manipulation of FreeCAD models through external commands.
Last updated: N/A
What is FreeCAD MCP?
FreeCAD MCP is a tool that allows you to control FreeCAD programmatically from Claude Desktop. It acts as a bridge, enabling you to automate design tasks, create models, and manipulate objects within FreeCAD using commands sent from Claude Desktop.
How to use FreeCAD MCP?
- Install the addon by cloning the repository and copying the
FreeCADMCPdirectory to your FreeCAD Mod directory (location varies by OS). 2. Restart FreeCAD and select the 'MCP Addon' workbench. 3. Start the RPC server using the 'Start RPC Server' command in the toolbar. 4. Configure Claude Desktop by editing theclaude_desktop_config.jsonfile to point to the FreeCAD MCP server. The configuration depends on whether you are a user or developer.
Key features of FreeCAD MCP
Control FreeCAD from Claude Desktop
Automated CAD design
RPC server for communication
Ability to execute arbitrary Python code in FreeCAD
Tools for creating, editing, and deleting objects
Use cases of FreeCAD MCP
Automated generation of CAD models based on input parameters
Remote control of FreeCAD for design tasks
Integration of FreeCAD with other applications through Claude Desktop
Creation of custom CAD workflows
Generating parts from 2D drawings
FAQ from FreeCAD MCP
Where is the FreeCAD Addon directory?
Where is the FreeCAD Addon directory?
The FreeCAD Addon directory varies depending on your operating system: Windows: %APPDATA%\FreeCAD\Mod\, Mac: ~/Library/Application Support/FreeCAD/Mod/, Linux: ~/.FreeCAD/Mod/ or ~/snap/freecad/common/Mod/ (if you install FreeCAD from snap)
How do I install the addon?
How do I install the addon?
Clone the repository, navigate to the addon/FreeCADMCP directory, and copy it to your FreeCAD Mod directory.
How do I start the RPC server?
How do I start the RPC server?
After installing the addon and restarting FreeCAD, select the 'MCP Addon' workbench and use the 'Start RPC Server' command in the toolbar.
How do I configure Claude Desktop?
How do I configure Claude Desktop?
Edit the claude_desktop_config.json file to specify the command and arguments for the FreeCAD MCP server. Refer to the README for user and developer configurations.
What tools are available?
What tools are available?
Available tools include create_document, create_object, edit_object, delete_object, execute_code, insert_part_from_library, get_view, get_objects, get_object, and get_parts_list.