这会带来什么

这是你的AI代理与FreeCAD之间的桥梁——一个在参数化设计、数控刀路生成和网格工作的思考伙伴。你带来设计意图和领域判断;代理负责FreeCAD的机制。一起：加快速度，协同设计那些手工构建需要数小时的东西，解开FreeCAD擅长生成的复杂错误信息，并寻找那些几乎无法单独发现的微妙、复杂的建模难题。专为个人日常使用设计设计、生成刀具路径、打印和切割而设计——而非演示。完整工具参考见 TOOLS.md。

你们可以一起努力的

• 设计流程 ——“我需要一个安装板——100x60mm，四个M3孔，圆角。正确的做法是什么？”你带来需求和约束;代理构建，标记未明确的决策，并与你一起迭代。
• 诊断出了什么问题 — “我刚尝试填充这个草图，结果很奇怪——FreeCAD到底告诉我什么？”代理可以阅读报告视图，检查草图约束，并用你可以采取的措辞解释发生了什么。

freecad-mcp

What This Does

This is a bridge between your AI agent and FreeCAD — a thinking partner for parametric design, CNC toolpath generation, and mesh work. You bring the design intent and the domain judgment; the agent handles the FreeCAD mechanics. Together: moving faster, co-designing things that would take hours to build by hand, untangling the cryptic error messages that FreeCAD is so good at generating, and hunting down the subtle, knotty modeling problems that are nearly impossible to find alone. Built for personal daily use — designing parts, generating toolpaths, printing and cutting them — not a demo. See TOOLS.md for the full tool reference.

What You Can Work On Together

• Work through a design — “I need a mounting plate — 100x60mm, four M3 holes, rounded corners. What’s the right approach?” You bring the requirements and constraints; the agent builds, flags underspecified decisions, and iterates with you.
• Diagnose what went wrong — “I just tried to pad this sketch and got a weird result — what is FreeCAD actually telling me?” The agent can read the Report View, inspect sketch constraints, and explain what’s happening in terms you can act on.
• Iterate on an existing part — “This wall feels too thin and the fillet might not survive printing — let’s look at it together”
• Plan CNC toolpaths — “I want to mill this pocket — let’s work out the right tool and parameters for the material”
• Build something reusable — “I keep doing this same workflow for every bracket — let’s write a macro that generates them from a spreadsheet of dimensions”
• Check your work before committing — “Does this model have geometry errors?”, “Will these walls survive printing?”, “Are any of these parts going to collide?”
• Work with meshes — “I have an STL from the manufacturer — let’s get it into FreeCAD and add mounting features”
• Export for manufacturing — “Export this as STEP and generate G-code for my CNC router”

See It In Action

These are a couple of examples of how I’ve used the MCP.

Debugging a broken external reference — a link FreeCAD can’t restore, an error message that seems to contradict what you know about your own model, and a one-line fix found by reading the file directly.

Full story →

---