尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
FreeCAD MCP 全解:16 个核心工具清单,一张表看懂 AI 如何驱动 FreeCAD
FreeCAD MCP 全解16 个核心工具清单一张表看懂 AI 如何驱动 FreeCAD【免费下载链接】freecad-mcpFreeCAD MCP(Model Context Protocol) server项目地址: https://gitcode.com/gh_mirrors/fr/freecad-mcpFreeCAD MCP 是一款开源的 MCPModel Context Protocol服务器让 Claude Desktop 等 AI 客户端能够驾驶三维建模软件 FreeCAD创建文档与零件、编辑属性、执行 Python 脚本、查看视图截图甚至运行 FEM 结构分析全部通过一句自然语言完成。本文用一张表盘点它的 16 个核心工具讲清三种代码执行模式与快速上手步骤帮助新手快速理解 AI 驱动 FreeCAD 的完整链路。一、FreeCAD MCP 是什么两个组件 一条通信通道 整个系统由两部分组成各司其职组件位置职责FreeCAD 端插件Addonaddon/FreeCADMCP/运行在 FreeCAD 内部提供工作台与 RPC Server默认监听127.0.0.1:9875外部 MCP Serversrc/freecad_mcp/由 AI 客户端通过uvx freecad-mcp启动把 AI 的工具调用翻译成对 FreeCAD 的 RPC 请求通信流程很简单AI 客户端 → MCP Server → XML-RPC → FreeCAD 插件 → 3D 模型。AI 说帮我建一个圆角法兰FreeCAD 里就会真的长出一个零件。安装插件后重启 FreeCAD即可在工作台列表底部看到MCP Addon选项选中该工作台并点击工具栏上的Start RPC ServerFreeCAD 状态栏会显示RPC Server started at 127.0.0.1:9875说明通道已就绪二、16 个核心工具清单一张表看懂 AI 能做什么 完整清单如下工具定义见 docs/tools.md实现集中在 src/freecad_mcp/server.py#分类工具作用可选截图1文档管理create_document新建 FreeCAD 文档❌2文档管理list_documents列出当前打开的文档❌3文档管理reload_document重新加载文档同步外部脚本保存的文件变更❌4对象操作create_object创建对象支持 Part、PartDesign、Fem 等类型✅5对象操作edit_object修改对象的属性✅6对象操作delete_object删除对象✅7对象操作get_objects获取文档中所有对象✅8对象操作get_object获取单个对象的属性详情✅9视图检查get_view获取当前视图截图9 种视角可指定尺寸✅10代码执行execute_code在 FreeCAD GUI 线程执行 Python默认 90 秒预算✅11代码执行execute_code_async后台线程跑重计算用commit()回写文档❌12代码执行get_async_status查询后台任务状态与失败堆栈❌13代码执行execute_code_headless在独立freecadcmd进程中跑脚本崩溃不影响 GUI❌14健康检查get_rpc_status报告 RPC/GUI 调度健康状态与版本一致性❌15零件库get_parts_list/insert_part_from_library查询并插入 FreeCAD 官方零件库中的现成零件✅16仿真分析run_fem_analysis调用 CalculiX 求解器运行 FEM 分析返回应力与位移摘要✅ 零件库一行实际包含 2 个工具get_parts_list负责查目录insert_part_from_library负责插入。截图是 FreeCAD MCP 的一大特色create_object、execute_code等 8 个工具默认会附带一张模型截图AI 能看到自己的建模结果从而自我纠错。常用参数include_screenshot默认true纯计算类步骤可设为false省 tokenview_name可选Isometric、Front、Top、Right等 9 种视角全局加--only-text-feedback参数可关闭所有可选截图见 docs/configuration.md。三、三种代码执行模式新手最需要理解的机制⚡execute_code只是入口真正体现工程设计的是三种执行模式的分层详解见 docs/execution.md工具运行位置适用场景execute_codeFreeCAD GUI 主线程常规建模自动化默认 90 秒队列 执行双预算慢任务可传timeout上限 1800 秒execute_code_async独立后台线程大布尔运算、放样等重几何计算文档/视图写入必须通过commit(fn)交回 GUI 线程避免卡死execute_code_headless独立freecadcmd进程可能崩溃的原生 OCCT 操作螺纹、复杂放样原生崩溃只终止辅助进程GUI 与打开的文档安然无恙配套的仪表盘get_async_status查询后台任务running/done/failed 异常堆栈get_rpc_status在 GUI 线程被卡住时仍能回答帮你定位是哪个操作stuck了。此外execute_code与execute_code_async共享一个持久脚本命名空间前一次调用定义的变量后一次还能直接用——这让 AI 可以分步完成复杂建模。四、FEM 结构分析一句跑一下仿真就够了run_fem_analysis会在已有的Fem::FemAnalysis容器上自动创建SolverCcxTools并运行 CalculiX 求解器返回最大 von Mises 应力MPa、最大/最小位移mm、节点数与求解工作目录默认超时 600 秒。配合create_object依次创建几何、Fem::MaterialCommon材料、Fem::FemMeshGmsh网格和约束后整个分析闭环都在对话里完成。项目提供了端到端示例examples/cantilever_fem.py构建悬臂梁、跑 CalculiX并与解析解对比验证。五、实战演示自然语言 → 三维零件 三个官方演示覆盖了 FreeCAD MCP 最典型的能力① 设计法兰AI 对话中逐步建模、倒角、截图确认即文首动图。② 设计玩具车从零搭建一个含车身、车轮的装配模型③ 从 2D 工程图建模把一张带尺寸的二维图纸直接丢给 AI它读图、建草图、生成三维实体。输入图纸示例建模过程演示更多演示与集成示例见 docs/examples.md仓库还附带了 Google ADK 智能体 和 LangChain / LangGraph 智能体 两套接入代码可以把 FreeCAD MCP 挂到你自己的 AI Agent 工作流里。六、快速上手三步接通 AI 与 FreeCAD 前置要求已安装 FreeCAD 与 uv / uvxMCP Server 需要 Python 3.12。第 1 步安装插件git clone https://gitcode.com/gh_mirrors/fr/freecad-mcp cd freecad-mcp把addon/FreeCADMCP目录复制到你系统的 FreeCAD 插件目录最终形成Mod/FreeCADMCP各平台的目录路径与复制命令见 docs/installation.md。第 2 步启动 RPC 服务重启 FreeCAD → 选择MCP Addon工作台 → 点击工具栏Start RPC Server状态栏出现监听地址即成功。可在 FreeCAD MCP 菜单中勾选Auto-Start Server实现开机自启。第 3 步接入 AI 客户端在 Claude Desktop 的claude_desktop_config.json中加入{ mcpServers: { freecad: { command: uvx, args: [freecad-mcp] } } }重启客户端对 AI 说一句创建一个边长 10 的方盒子FreeCAD 里就会出现这个盒子。七、连接遇到问题用健康检查工具自救 排障三板斧get_rpc_status报告 RPC 连通性、GUI 调度健康状态以及插件与 Server 的版本一致性version_check为 ok 或提示哪一侧需要更新查看 Report View 的启动日志端口被占用等失败原因会直接显示例如核对两侧版本插件与freecad-mcp包独立更新版本不一致时每次工具响应开头会带警告告诉你该更新哪一侧若 GUI 线程卡死stuck按 docs/execution.md 的Recover from a stuck GUI operation章节处理必要时重启 FreeCAD。其他高频问题远程连接RPC 服务默认只监听 localhost跨机器控制需开启 Remote Connections、配置 Allowed IPs 并建议设置 Auth Token详见 docs/configuration.md端口验证用 PowerShell 的Test-NetConnection或外部 Python 脚本ping()确认 9875 端口背后确实是 FreeCAD 的 XML-RPC 服务Windows 客户端报错uv_spawn可尝试用cmd /c freecad-mcp方式启动属客户端层面的兼容处理。小结FreeCAD MCP 的价值是把会写 Python这个门槛从 AI 建模的必经之路上拿掉了16 个工具覆盖文档、对象、视图、代码、零件库与 FEM 全流程三种执行模式兼顾了安全性与性能再加上截图反馈AI 能看、能做、能查错。装好插件、连上客户端你就可以像布置工作一样对 FreeCAD 说话了。 延伸阅读安装指南 · 配置说明 · 工具清单 · 代码执行详解 · 演示与示例【免费下载链接】freecad-mcpFreeCAD MCP(Model Context Protocol) server项目地址: https://gitcode.com/gh_mirrors/fr/freecad-mcp创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED

相关推荐

AI全栈实战 | 2.4-01 Node 与前端工程化:前端为什么离不开 Node,它不只是构建工具的宿主

AI全栈实战 | 2.4-01 Node 与前端工程化:前端为什么离不开 Node,它不只是构建工具的宿主

上篇回顾:2.3-01 讲了用 Element Plus 快速搭管理后台 二次封装原则。本篇进入前端工程化——Node.js 是前端世界的「后端运行时」,所有构建工具(Vite/Webpack/esbuild)都跑在 Node 上。但 Node 对前端的意义远不止「构建工具的宿…

📅 2026/10/3 0:26:29
superpowers实战:为AI编码代理构建可复用工作流

superpowers实战:为AI编码代理构建可复用工作流

最近在开发者圈子里,“superpowers” 这个词被反复提起。说的不是美漫里的超能力,而是一套给 AI 编码代理做技能增强的开源工具链。我花了两周时间,把它的安装、初始化、日常任务流程完整跑了一遍,还专门拉了一个 Java 后端项目试…

📅 2026/10/3 0:21:28
AI智能体实战:从技能创建到多技能协作编排指南

AI智能体实战:从技能创建到多技能协作编排指南

朋友听说我在养小龙虾,都以为我转行搞水产了。其实我养的不是那种红壳钳子虾,而是一只用技能喂大的AI龙虾——一个真正能干活的智能体(Agent)。这半年来我在各种AI平台和开源框架里反复折腾,前前后后安装、测试、废弃过…

📅 2026/10/3 0:21:28
MORE NEWS

更多资讯

📰

Paperclip文件上传实战:配置、踩坑与Active Storage迁移指南

做 Rails 开发的朋友,如果经历过 2015 到 2019 那几年,应该对 Paperclip 这个名字不陌生。它是 thoughtbot 出品的文件附件处理库,当年在 GitHub 上的星标数量一度碾压同类型的 CarrierWave,几乎所有跟图片上传、文件管理沾边的 R…

📰

PDF解析到知识图谱:从文本抽取到Neo4j检索的完整链路

简介:该项目使用Python实现了从PDF解析、信息抽取到知识图谱构建及检索的完整流程,适合计算机、数学、电子信息类专业的学生作为课程设计、期末大作业或毕业设计参考。核心功能包括PDF文档内容识别、实体与关系抽取、知识图谱存储与基于图谱的语义检索&a…

📰

螺旋矩阵满分解法:方向数组与四边界收缩全解析

力扣hot100第19题螺旋矩阵,第一次写的人大概率会经历这个流程:看题觉得简单,写起来也快,提交却报错,然后陷入“到底哪里没判断到”的自我怀疑。我当年也是这样,样例一次过,一提交就翻车&#xf…

📰

论文平台承诺的退款到底退哪些钱?本科生与研究生都该核对的退款范围清单

把「退款」这两个字拆开看,真正决定钱能不能回到账上的,其实是三件事:哪些服务被写进了范围、按哪一份报告来判定、以什么口径认定超标。知学术AIPaperGPT 对外公示的口径是查重>15% 或 AIGC>10% 全额退款,检测通道对接知网…

📰

AutoTransition:用强化学习自动生成视频转场的开源方案

1. 先聊聊视频转场这个"小事"做视频剪辑的朋友应该都有过这种体验:一段素材剪完之后,卡在两段画面的衔接处,不知道该用硬切还是叠化,更别说那些花字转场、缩放推进、百叶窗效果了。选对了,整个片子节奏顺畅&…

📰

从零搭建AI工程化系统:数据管道、模型部署与监控闭环

最近两个月,我一直在做一件在别人看来有点“自找麻烦”的事:把一个 AI 需求从零开始,完完整整地做成能上线跑的业务系统。这里说的从零,不只是从空目录开始写代码,而是从业务问题定义、数据盘点、模型选型,…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬