FreeCAD MCP 进阶实战指南如何用 LangChain 与 Google ADK 打造专属 CAD Agent【免费下载链接】freecad-mcpFreeCAD MCP(Model Context Protocol) server项目地址: https://gitcode.com/gh_mirrors/fr/freecad-mcpFreeCAD MCP是一个 Model Context ProtocolMCP服务器能把 FreeCAD 强大的参数化建模能力开放给 AI 客户端创建与编辑模型、执行 Python 脚本、检查文档、运行 FEM 有限元分析。本文带你从能用的 MCP 连接进阶到可定制的专属 CAD Agent——通过LangChain / LangGraph与Google ADK两套主流框架在 10 分钟量级内搭出一个会自己建模的 AI 工程师。 读完本文你能收获理解 MCP 工具如何接入 Agent 框架、跑通 LangChain 交互式 CAD 助手、部署 ADK 版 CAD 设计 Agent、以及一套常见的排错清单。一、为什么 CAD Agent 离不开 MCP先看 FreeCAD MCP 能做什么。下图是 Claude 通过 MCP 在 FreeCAD 中设计法兰的全过程——Agent 自己规划步骤、调用建模工具、检查视图截图并修正全程无需人工干预MCP 服务器的核心职责是把 FreeCAD 封装成一组标准化工具tools暴露给任意 Agent 框架。常用工具包括详见 docs/tools.md工具用途create_document/create_object/edit_object建模基础三件套建文档、建对象、改属性execute_code/execute_code_async在 FreeCAD GUI 线程或后台执行 Python 代码get_view返回当前视图截图让多模态模型看见模型insert_part_from_library从 FreeCAD 零件库插入现成零件run_fem_analysis调用 CalculiX 求解器做结构分析这套工具接口与框架无关——LangChain、Google ADK、Claude Desktop 都能直接消费。这正是 MCP 的价值一次接入处处复用。二、运行前置启动 FreeCAD MCP 服务Agent 示例都依赖本地运行的 FreeCAD MCP。完整步骤见 docs/installation.md核心只有 3 步安装 addon把仓库里的 addon/FreeCADMCP/ 目录复制到 FreeCAD 的Mod/插件目录各平台路径表见安装文档重启 FreeCAD启动 RPC 服务切换到MCP Addon工作台点击工具栏的Start RPC Server保持 FreeCAD 处于打开状态——Agent 连接的是localhostFreeCAD 关闭则服务不可用。启动成功的界面如下启动失败时的界面同样附在文末方便对照排错⚠️ 两个高频错误路径写错示例代码里的path/to/freecad-mcp必须替换成你本地仓库的实际绝对路径不要把freecad-mcp包装进 FreeCAD 自带的 Python——MCP 服务器要求 Python 3.12由uv独立管理。三、LangChain 方案交互式 CAD Agent 实战官方示例 examples/langchain/react.py 用 LangGraph 的create_react_agent搭建了一个命令行交互式 CAD 助手模型选用 Groq 的llama-3.1-8b-instant速度快、成本低适合入门。它的架构可以概括为一条链路stdio_client拉起 freecad-mcp → load_mcp_tools自动发现全部 MCP 工具 → create_react_agentLLM 工具 ReAct Agent → 用户输入 → Agent 循环思考/调用工具 → 回复关键代码只有几行核心是这两处server_params StdioServerParameters( commanduv, args[--directory, path/to/freecad-mcp, run, freecad-mcp] ) # 工具自动加载无需逐个手写 tools await load_mcp_tools(session) agent create_react_agent(llm, tools)运行前设置环境变量GROQ_API_KEY然后执行python examples/langchain/react.py即可进入对话循环输入exit退出。实战技巧ReAct Agent 的优势在于思考-行动-观察循环。你只需给出高层指令例如做一个 10cm 长的悬臂梁Agent 会自动拆解成create_document→create_object→get_view等多步调用并根据截图反馈自我修正。四、Google ADK 方案声明式配置一个 CAD 设计 Agentexamples/adk/agent.py 展示了 Google ADK 的写法——更加声明式全部配置集中在一个LlmAgent里root_agent LlmAgent( modelgemini-2.5-flash-lite, namecad_design_agent, instructionYou are a CAD designer., tools[ MCPToolset( connection_paramsStdioServerParameters( commanduv, args[--directory, FREECAD_MCP_DIR, run, freecad-mcp] ) ) ] )MCPToolset会自动把 freecad-mcp 的全部工具注册进 Agent无需手写工具映射。得益于 Gemini 的多模态能力Agent 可以直接理解get_view返回的截图判断建模结果是否符合预期。五、两个 Agent 框架怎么选维度LangChain / LangGraphGoogle ADK风格代码驱动、细粒度可控声明式配置、上手极快模型任意 LangChain 支持的模型示例用 GroqGemini 系列示例用 flash-lite交互形态自带交互式命令行循环与 ADK 生态集成Web、API 部署适用场景已有 LangChain 技术栈、需要定制 Agent 循环快速验证想法、面向 Google 生态部署依赖langchain、langgraph、mcp适配层google-adk两者消费的都是同一套 MCP 工具——切换框架时FreeCAD 侧零改动。六、让 Agent 更聪明的定制技巧写更具体的 instruction示例中的You are a CAD designer.只是起点。你可以补充工作流约束例如先建文档→建模→必须调用 get_view 截图自检→有偏差再修正Agent 的可靠性会明显提升善用截图反馈多数建模工具支持include_screenshot参数默认开启见 docs/tools.md让多模态模型看到结果纯文本分析步骤可关闭截图以省 token换模型LangChain 示例把ChatGroq换成任意ChatModel即可ADK 示例修改MODEL_NAME即可进阶到 FEM 分析Agent 不只建模。配合 examples/cantilever_fem.py 的思路可以让 Agent 建悬臂梁、设材料、划分网格并调用run_fem_analysis把最大 von Mises 应力和位移与解析解对比——一个会做结构校核的 CAD Agent 就诞生了。七、常见问题排查清单❓Agent 报错连不上 FreeCADFreeCAD 是否开着RPC 服务器是否已启动对照正常界面下图检查启动状态用 MCP 的get_rpc_status工具可直接查询 RPC 健康状态与 addon 版本。❓提示GROQ_API_KEY is missingLangChain 示例依赖 Groq 模型需在环境变量中配置 API Key。❓工作台缺失 / 工具无响应打开 FreeCAD 的 View → Panels → Report view检查 addon 导入错误参考 docs/execution.md 处理超时问题。写在最后FreeCAD MCP 把AI 操作 FreeCAD的门槛降到了接一个 MCP 地址的距离而 LangChain 与 Google ADK 两个官方示例examples/langchain/react.py、examples/adk/agent.py则证明从演示到生产可用的专属 CAD Agent中间只差一段可定制的代码。更完整的工具清单见 docs/tools.md更多演示玩具车、2D 图纸建模见 docs/examples.md。现在打开 FreeCAD让你的 Agent 开始干活吧【免费下载链接】freecad-mcpFreeCAD MCP(Model Context Protocol) server项目地址: https://gitcode.com/gh_mirrors/fr/freecad-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考