FreeCAD MCP 全解16 個(gè)核心工具清單一張表看懂 AI 如何驅(qū)動(dòng) FreeCAD【免費(fèi)下載鏈接】freecad-mcpFreeCAD MCP(Model Context Protocol) server項(xiàng)目地址: https://gitcode.com/gh_mirrors/fr/freecad-mcpFreeCAD MCP 是一款開源的 MCPModel Context Protocol服務(wù)器讓 Claude Desktop 等 AI 客戶端能夠駕駛?cè)S建模軟件 FreeCAD創(chuàng)建文檔與零件、編輯屬性、執(zhí)行 Python 腳本、查看視圖截圖甚至運(yùn)行 FEM 結(jié)構(gòu)分析全部通過一句自然語言完成。本文用一張表盤點(diǎn)它的 16 個(gè)核心工具講清三種代碼執(zhí)行模式與快速上手步驟幫助新手快速理解 AI 驅(qū)動(dòng) FreeCAD 的完整鏈路。一、FreeCAD MCP 是什么兩個(gè)組件 一條通信通道 整個(gè)系統(tǒng)由兩部分組成各司其職組件位置職責(zé)FreeCAD 端插件Addonaddon/FreeCADMCP/運(yùn)行在 FreeCAD 內(nèi)部提供工作臺(tái)與 RPC Server默認(rèn)監(jiān)聽127.0.0.1:9875外部 MCP Serversrc/freecad_mcp/由 AI 客戶端通過uvx freecad-mcp啟動(dòng)把 AI 的工具調(diào)用翻譯成對(duì) FreeCAD 的 RPC 請(qǐng)求通信流程很簡(jiǎn)單AI 客戶端 → MCP Server → XML-RPC → FreeCAD 插件 → 3D 模型。AI 說幫我建一個(gè)圓角法蘭FreeCAD 里就會(huì)真的長(zhǎng)出一個(gè)零件。安裝插件后重啟 FreeCAD即可在工作臺(tái)列表底部看到MCP Addon選項(xiàng)選中該工作臺(tái)并點(diǎn)擊工具欄上的Start RPC ServerFreeCAD 狀態(tài)欄會(huì)顯示RPC Server started at 127.0.0.1:9875說明通道已就緒二、16 個(gè)核心工具清單一張表看懂 AI 能做什么 完整清單如下工具定義見 docs/tools.md實(shí)現(xiàn)集中在 src/freecad_mcp/server.py#分類工具作用可選截圖1文檔管理create_document新建 FreeCAD 文檔?2文檔管理list_documents列出當(dāng)前打開的文檔?3文檔管理reload_document重新加載文檔同步外部腳本保存的文件變更?4對(duì)象操作create_object創(chuàng)建對(duì)象支持 Part、PartDesign、Fem 等類型?5對(duì)象操作edit_object修改對(duì)象的屬性?6對(duì)象操作delete_object刪除對(duì)象?7對(duì)象操作get_objects獲取文檔中所有對(duì)象?8對(duì)象操作get_object獲取單個(gè)對(duì)象的屬性詳情?9視圖檢查get_view獲取當(dāng)前視圖截圖9 種視角可指定尺寸?10代碼執(zhí)行execute_code在 FreeCAD GUI 線程執(zhí)行 Python默認(rèn) 90 秒預(yù)算?11代碼執(zhí)行execute_code_async后臺(tái)線程跑重計(jì)算用commit()回寫文檔?12代碼執(zhí)行g(shù)et_async_status查詢后臺(tái)任務(wù)狀態(tài)與失敗堆棧?13代碼執(zhí)行execute_code_headless在獨(dú)立freecadcmd進(jìn)程中跑腳本崩潰不影響 GUI?14健康檢查get_rpc_status報(bào)告 RPC/GUI 調(diào)度健康狀態(tài)與版本一致性?15零件庫(kù)get_parts_list/insert_part_from_library查詢并插入 FreeCAD 官方零件庫(kù)中的現(xiàn)成零件?16仿真分析run_fem_analysis調(diào)用 CalculiX 求解器運(yùn)行 FEM 分析返回應(yīng)力與位移摘要? 零件庫(kù)一行實(shí)際包含 2 個(gè)工具get_parts_list負(fù)責(zé)查目錄insert_part_from_library負(fù)責(zé)插入。截圖是 FreeCAD MCP 的一大特色create_object、execute_code等 8 個(gè)工具默認(rèn)會(huì)附帶一張模型截圖AI 能看到自己的建模結(jié)果從而自我糾錯(cuò)。常用參數(shù)include_screenshot默認(rèn)true純計(jì)算類步驟可設(shè)為false省 tokenview_name可選Isometric、Front、Top、Right等 9 種視角全局加--only-text-feedback參數(shù)可關(guān)閉所有可選截圖見 docs/configuration.md。三、三種代碼執(zhí)行模式新手最需要理解的機(jī)制?execute_code只是入口真正體現(xiàn)工程設(shè)計(jì)的是三種執(zhí)行模式的分層詳解見 docs/execution.md工具運(yùn)行位置適用場(chǎng)景execute_codeFreeCAD GUI 主線程常規(guī)建模自動(dòng)化默認(rèn) 90 秒隊(duì)列 執(zhí)行雙預(yù)算慢任務(wù)可傳timeout上限 1800 秒execute_code_async獨(dú)立后臺(tái)線程大布爾運(yùn)算、放樣等重幾何計(jì)算文檔/視圖寫入必須通過commit(fn)交回 GUI 線程避免卡死execute_code_headless獨(dú)立freecadcmd進(jìn)程可能崩潰的原生 OCCT 操作螺紋、復(fù)雜放樣原生崩潰只終止輔助進(jìn)程GUI 與打開的文檔安然無恙配套的儀表盤get_async_status查詢后臺(tái)任務(wù)running/done/failed 異常堆棧get_rpc_status在 GUI 線程被卡住時(shí)仍能回答幫你定位是哪個(gè)操作stuck了。此外execute_code與execute_code_async共享一個(gè)持久腳本命名空間前一次調(diào)用定義的變量后一次還能直接用——這讓 AI 可以分步完成復(fù)雜建模。四、FEM 結(jié)構(gòu)分析一句跑一下仿真就夠了run_fem_analysis會(huì)在已有的Fem::FemAnalysis容器上自動(dòng)創(chuàng)建SolverCcxTools并運(yùn)行 CalculiX 求解器返回最大 von Mises 應(yīng)力MPa、最大/最小位移mm、節(jié)點(diǎn)數(shù)與求解工作目錄默認(rèn)超時(shí) 600 秒。配合create_object依次創(chuàng)建幾何、Fem::MaterialCommon材料、Fem::FemMeshGmsh網(wǎng)格和約束后整個(gè)分析閉環(huán)都在對(duì)話里完成。項(xiàng)目提供了端到端示例examples/cantilever_fem.py構(gòu)建懸臂梁、跑 CalculiX并與解析解對(duì)比驗(yàn)證。五、實(shí)戰(zhàn)演示自然語言 → 三維零件 三個(gè)官方演示覆蓋了 FreeCAD MCP 最典型的能力① 設(shè)計(jì)法蘭AI 對(duì)話中逐步建模、倒角、截圖確認(rèn)即文首動(dòng)圖。② 設(shè)計(jì)玩具車從零搭建一個(gè)含車身、車輪的裝配模型③ 從 2D 工程圖建模把一張帶尺寸的二維圖紙直接丟給 AI它讀圖、建草圖、生成三維實(shí)體。輸入圖紙示例建模過程演示更多演示與集成示例見 docs/examples.md倉(cāng)庫(kù)還附帶了 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把a(bǔ)ddon/FreeCADMCP目錄復(fù)制到你系統(tǒng)的 FreeCAD 插件目錄最終形成Mod/FreeCADMCP各平臺(tái)的目錄路徑與復(fù)制命令見 docs/installation.md。第 2 步啟動(dòng) RPC 服務(wù)重啟 FreeCAD → 選擇MCP Addon工作臺(tái) → 點(diǎn)擊工具欄Start RPC Server狀態(tài)欄出現(xiàn)監(jiān)聽地址即成功?？稍?FreeCAD MCP 菜單中勾選Auto-Start Server實(shí)現(xiàn)開機(jī)自啟。第 3 步接入 AI 客戶端在 Claude Desktop 的claude_desktop_config.json中加入{ mcpServers: { freecad: { command: uvx, args: [freecad-mcp] } } }重啟客戶端對(duì) AI 說一句創(chuàng)建一個(gè)邊長(zhǎng) 10 的方盒子FreeCAD 里就會(huì)出現(xiàn)這個(gè)盒子。七、連接遇到問題用健康檢查工具自救 排障三板斧get_rpc_status報(bào)告 RPC 連通性、GUI 調(diào)度健康狀態(tài)以及插件與 Server 的版本一致性version_check為 ok 或提示哪一側(cè)需要更新查看 Report View 的啟動(dòng)日志端口被占用等失敗原因會(huì)直接顯示例如核對(duì)兩側(cè)版本插件與freecad-mcp包獨(dú)立更新版本不一致時(shí)每次工具響應(yīng)開頭會(huì)帶警告告訴你該更新哪一側(cè)若 GUI 線程卡死stuck按 docs/execution.md 的Recover from a stuck GUI operation章節(jié)處理必要時(shí)重啟 FreeCAD。其他高頻問題遠(yuǎn)程連接RPC 服務(wù)默認(rèn)只監(jiān)聽 localhost跨機(jī)器控制需開啟 Remote Connections、配置 Allowed IPs 并建議設(shè)置 Auth Token詳見 docs/configuration.md端口驗(yàn)證用 PowerShell 的Test-NetConnection或外部 Python 腳本ping()確認(rèn) 9875 端口背后確實(shí)是 FreeCAD 的 XML-RPC 服務(wù)Windows 客戶端報(bào)錯(cuò)uv_spawn可嘗試用cmd /c freecad-mcp方式啟動(dòng)屬客戶端層面的兼容處理。小結(jié)FreeCAD MCP 的價(jià)值是把會(huì)寫 Python這個(gè)門檻從 AI 建模的必經(jīng)之路上拿掉了16 個(gè)工具覆蓋文檔、對(duì)象、視圖、代碼、零件庫(kù)與 FEM 全流程三種執(zhí)行模式兼顧了安全性與性能再加上截圖反饋AI 能看、能做、能查錯(cuò)。裝好插件、連上客戶端你就可以像布置工作一樣對(duì) FreeCAD 說話了。 延伸閱讀安裝指南 · 配置說明 · 工具清單 · 代碼執(zhí)行詳解 · 演示與示例【免費(fèi)下載鏈接】freecad-mcpFreeCAD MCP(Model Context Protocol) server項(xiàng)目地址: https://gitcode.com/gh_mirrors/fr/freecad-mcp創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考