freecad-mcp-setup
v1.0.8
Published
Easy installer for FreeCAD MCP - Control FreeCAD with Claude AI
Downloads
409
Maintainers
Readme
FreeCAD MCP Setup
Easy installer for FreeCAD MCP - Control FreeCAD with Claude AI through natural language.
Quick Install
npm install -g freecad-mcp-setup
freecad-mcp setupFeatures
- ✅ Cross-platform - macOS, Linux, Windows support
- ✅ Smart detection - Finds FreeCAD installation automatically
- ✅ Update checking - Prompts when new versions are available
- ✅ Zero configuration - Registers MCP server automatically
- ✅ Error handling - Clear error messages and recovery steps
Commands
freecad-mcp setup # Install or check for updates
freecad-mcp setup --update # Force update to latest version
freecad-mcp --help # Show help informationWhat It Does
- Checks if FreeCAD 1.0+ is installed
- Downloads latest FreeCAD MCP release from GitHub
- Installs AI Copilot workbench to correct location
- Registers MCP server with Claude Code
- Tests the connection and provides next steps
Requirements
- FreeCAD 1.0+ - Download here
- Node.js 14+ - For running the installer
- Claude Code -
npm install -g claude-code
Manual Installation
If you prefer manual installation, see the main repository.
Troubleshooting
FreeCAD not found:
- Install FreeCAD 1.0+ from https://freecad.org/downloads.php
Claude Code not found:
- Install with:
npm install -g claude-code
Permission errors:
- Run with appropriate permissions for your OS
- On macOS/Linux: Check file permissions with
ls -la
License
LGPL-2.1-or-later (same as FreeCAD)
