FreeCAD-MCP (ATOI-Ming)
A macro-centric FreeCAD MCP plugin with a GUI control panel, a client for running macros, and view management inside FreeCAD.
What it does and how it connects
FreeCAD MCP from ATOI-Ming is a plugin that integrates the Model Context Protocol into FreeCAD for automation of model creation, macro execution, and view management through a server-client architecture. It provides a GUI control panel and a command-line client, and it integrates with external tools such as Claude, Cursor, Trace, and CodeBuddy.
The server handles commands including create_macro, update_macro, run_macro, set_view, and get_report. The client sends commands over stdio or TCP, manages .FCMacro files, and controls FreeCAD remotely. Macros are normalized automatically with imports for FreeCAD, FreeCADGui, Part, and math, plus post-execution recompute and view adjustment.
The GUI control panel has buttons to start and stop the server, clear logs, and switch views between front, top, right, and axonometric, and the plugin adds a FreeCADMCP workbench with toolbar and menu commands. It requires FreeCAD 0.21 or higher. The README shows example models including a gear, a flange, a boat, and a table.
What engineers report
你好，安装的时候提示mcp-server没有1.2.0版本。依赖都按照要求安装了。pip最新时0.1.4. 请问我该如何安装？
2025-12-10Read the original
Alternatives
Compare side by side- freecad-mcp (neka-nat)
The most widely used FreeCAD MCP server, with an addon plus server split and FEM analysis, rather than a macro-centric plugin with a GUI panel.
- freecad-mcp (blwfish)
A FreeCAD MCP bridge built for daily use with 32 tools for modeling, CAM, and diagnostics, rather than a macro-centric plugin.
- freecad-addon-robust-mcp-server (spkane)
A FreeCAD MCP suite with 150 plus tools, headless mode, and connection resilience, rather than a macro-centric plugin.
- freecad_mcp (bonninr)
A minimal socket-based MCP workbench with two core commands, rather than a macro-centric plugin with a GUI control panel.
Recurring errors it addresses
Error Index entries this tool is built to reduce or work around.
- A CAD agent bridge's screenshot tool refused any image over a 50KB socket frame, so every real model screenshot was dropped, and images that did fit arrived as base64 text inside JSON instead of real image blocks. The agent's only visual feedback channel was dead for production-scale models.Error Index
- When an agent fans out parallel create calls through the FreeCAD MCP bridge, the shared connection races: the first object is created even though its call reports failure, and the second object is silently never created with the status still showing healthy.Error Index
- A FreeCAD MCP bridge's autosave-before-call rewrote the active document on every tool call even with zero unsaved changes, stamping phantom diffs onto git-tracked CAD files. Agent activity pollutes version control with edits no human authored.Error Index
- A FreeCAD MCP bridge reported clean instance shutdowns as failures 100 percent of the time on Linux, because its liveness check polled immediately after signaling the process group. The agent was sent to retry or kill processes that were already gone.Error Index
- A FreeCAD MCP bridge silently ignored parameters the client materialized from JSON-Schema defaults, so box(size=20) produced a default 10mm shape. The agent believes it built the requested geometry while the model is something else entirely.Error Index
Sources
Not verified
- No GitHub releases exist, so latest release fields are null.
- Pricing: none stated on the repo.
- Activity: last push June 2026, so the project looks quiet; no newer release was found.
Last verified November 6, 2026. Listings are informational. The evidence score measures public, verifiable evidence and is not an endorsement or a compatibility claim.