Control FreeCAD via MCP to create and modify 3D models, automate CAD tasks, solve constraints, and integrate part libraries programmatically.
# FreeCAD MCP Skill
Enable AI agents to control FreeCAD via the Model Context Protocol (MCP). Create 3D models programmatically, generate parts from descriptions, and automate CAD workflows.
## Features
- 🦾 Full FreeCAD control via RPC server
- Create 3D objects from 2D drawings
- Automatic constraint solving
- Part library integration
- Compatible with LangChain and Google ADK agents
## Requirements
- FreeCAD 0.21+ installed
- Python 3.10+
- MCP-enabled AI agent
## Installation
### 1. Install the skill
```
npx clawhub install openclaw-freecad-mcp
```
### 2. Install the FreeCAD addon
Copy the `addon/FreeCADMCP` folder to your FreeCAD addons directory:
- **macOS**: `~/Library/Application Support/FreeCAD/Mod`
- **Linux**: `~/.FreeCAD/Mod`
- **Windows**: `%APPDATA%\FreeCAD\Mod`
### 3. Start the RPC server
In FreeCAD, go to Workbenches → FreeCAD MCP → Start RPC Server
### 4. Configure your agent
Add the MCP server endpoint to your agent configuration:
```json
{
"mcpServers": {
"freecad": {
"url": "http://localhost:9876"
}
}
}
```
## Usage
Example agent prompts:
- "Create a 50x50x10 mm cube with a centered 20mm hole"
- "Turn this 2D sketch into a 3D printable model"
- "Design a toy car body with integrated axles"
## Examples
See the `examples/` directory for:
- LangChain React agent example
- Google ADK agent example
## Author
[mars720816](https://github.com/mars720816)
## License
MIT
don't have the plugin yet? install it then click "run inline in claude" again.