FreeCAD-MCP
FreeCAD-MCP is a FreeCAD workbench/plugin that exposes FreeCAD automation capabilities through the Model Context Protocol (MCP). It includes an MCP server with a GUI control panel, plus a Python client that can create/update/validate/run FreeCAD macros (FCMacro), adjust 3D views, and retrieve execution logs/reports. Communication is via stdio or TCP and integrates macro normalization (imports, recompute, view adjustment) before running.
Score Breakdown
⚙ Agent Friendliness
🔒 Security
No auth is documented for MCP server/client. The client can connect via TCP (even if localhost), which increases risk if exposed. The system executes/normalizes arbitrary macro Python code, so it should not be used with untrusted inputs. Logs are written to a temp file; secret handling specifics (e.g., redaction) are not described.
⚡ Reliability
Best When
You control the FreeCAD environment and the macro/code inputs, and you want an agent-friendly way to drive FreeCAD through MCP for local automation.
Avoid When
You need to run untrusted or user-supplied code/macros, or you require secure multi-tenant access over a network without additional hardening.
Use Cases
- • Automate parametric model creation in FreeCAD via text/code-generated macros
- • Remote/control FreeCAD macro execution from an AI tool or external workflow using MCP
- • Batch generation of CAD models by running multiple macros sequentially
- • Programmatically switch views (front/top/right/axonometric) and capture execution reports/logs
- • Validate macro code before executing to reduce runtime errors
Not For
- • Security-sensitive or untrusted macro execution in shared environments (macros are arbitrary Python)
- • Production-grade service deployments that require robust authentication/authorization and strong network security controls
- • Headless/CI usage without careful environment setup (FreeCAD GUI context and paths may be required)
Interface
Authentication
No authentication/authorization is described for MCP server/client. Access appears local by default (stdio) and optionally via TCP localhost, but without documented auth or access control.
Pricing
Open-source (MIT) plugin; no pricing information provided.
Agent Metadata
Known Gotchas
- ⚠ Macro inputs are Python code; agents should treat provided code as privileged and avoid untrusted inputs
- ⚠ Path configuration (mcp_config.json and command args) is commonly a failure point (README highlights incorrect paths)
- ⚠ TCP port 9876 conflicts can prevent startup (README notes port-in-use troubleshooting)
- ⚠ Server behavior depends on FreeCAD environment and write permissions to temp/log locations
Alternatives
Full Evaluation Report
Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for FreeCAD-MCP.
AI-powered analysis · PDF + markdown · Delivered within 30 minutes
Package Brief
Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.
Delivered within 10 minutes
Score Monitoring
Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.
Continuous monitoring
Scores are editorial opinions as of 2026-03-30.