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創(chuàng)建文檔與零件、編輯屬性、執(zhí)行 Python 腳本、查看視圖截圖甚至運行 FEM 結構分析全部通過一句自然語言完成。本文用一張表盤點它的 16 個核心工具講清三種代碼執(zhí)行模式與快速上手步驟幫助新手快速理解 AI 驅動 FreeCAD 的完整鏈路。一、FreeCAD MCP 是什么兩個組件 一條通信通道 整個系統(tǒng)由兩部分組成各司其職組件位置職責FreeCAD 端插件Addonaddon/FreeCADMCP/運行在 FreeCAD 內部提供工作臺與 RPC Server默認監(jiān)聽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 狀態(tài)欄會顯示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創(chuàng)建對象支持 Part、PartDesign、Fem 等類型?5對象操作edit_object修改對象的屬性?6對象操作delete_object刪除對象?7對象操作get_objects獲取文檔中所有對象?8對象操作get_object獲取單個對象的屬性詳情?9視圖檢查get_view獲取當前視圖截圖9 種視角可指定尺寸?10代碼執(zhí)行execute_code在 FreeCAD GUI 線程執(zhí)行 Python默認 90 秒預算?11代碼執(zhí)行execute_code_async后臺線程跑重計算用commit()回寫文檔?12代碼執(zhí)行get_async_status查詢后臺任務狀態(tài)與失敗堆棧?13代碼執(zhí)行execute_code_headless在獨立freecadcmd進程中跑腳本崩潰不影響 GUI?14健康檢查get_rpc_status報告 RPC/GUI 調度健康狀態(tài)與版本一致性?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。三、三種代碼執(zhí)行模式新手最需要理解的機制?execute_code只是入口真正體現工程設計的是三種執(zhí)行模式的分層詳解見 docs/execution.md工具運行位置適用場景execute_codeFreeCAD GUI 主線程常規(guī)建模自動化默認 90 秒隊列 執(zhí)行雙預算慢任務可傳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容器上自動創(chuàng)建SolverCcxTools并運行 CalculiX 求解器返回最大 von Mises 應力MPa、最大/最小位移mm、節(jié)點數與求解工作目錄默認超時 600 秒。配合create_object依次創(chuàng)建幾何、Fem::MaterialCommon材料、Fem::FemMeshGmsh網格和約束后整個分析閉環(huán)都在對話里完成。項目提供了端到端示例examples/cantilever_fem.py構建懸臂梁、跑 CalculiX并與解析解對比驗證。五、實戰(zhàn)演示自然語言 → 三維零件 三個官方演示覆蓋了 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目錄復制到你系統(tǒng)的 FreeCAD 插件目錄最終形成Mod/FreeCADMCP各平臺的目錄路徑與復制命令見 docs/installation.md。第 2 步啟動 RPC 服務重啟 FreeCAD → 選擇MCP Addon工作臺 → 點擊工具欄Start RPC Server狀態(tài)欄出現監(jiān)聽地址即成功?？稍?FreeCAD MCP 菜單中勾選Auto-Start Server實現開機自啟。第 3 步接入 AI 客戶端在 Claude Desktop 的claude_desktop_config.json中加入{ mcpServers: { freecad: { command: uvx, args: [freecad-mcp] } } }重啟客戶端對 AI 說一句創(chuàng)建一個邊長 10 的方盒子FreeCAD 里就會出現這個盒子。七、連接遇到問題用健康檢查工具自救 排障三板斧get_rpc_status報告 RPC 連通性、GUI 調度健康狀態(tài)以及插件與 Server 的版本一致性version_check為 ok 或提示哪一側需要更新查看 Report View 的啟動日志端口被占用等失敗原因會直接顯示例如核對兩側版本插件與freecad-mcp包獨立更新版本不一致時每次工具響應開頭會帶警告告訴你該更新哪一側若 GUI 線程卡死stuck按 docs/execution.md 的Recover from a stuck GUI operation章節(jié)處理必要時重啟 FreeCAD。其他高頻問題遠程連接RPC 服務默認只監(jiān)聽 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 全流程三種執(zhí)行模式兼顧了安全性與性能再加上截圖反饋AI 能看、能做、能查錯。裝好插件、連上客戶端你就可以像布置工作一樣對 FreeCAD 說話了。 延伸閱讀安裝指南 · 配置說明 · 工具清單 · 代碼執(zhí)行詳解 · 演示與示例【免費下載鏈接】freecad-mcpFreeCAD MCP(Model Context Protocol) server項目地址: https://gitcode.com/gh_mirrors/fr/freecad-mcp創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考 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創(chuàng)建文檔與零件、編輯屬性、執(zhí)行 Python 腳本、查看視圖截圖甚至運行 FEM 結構分析全部通過一句自然語言完成。本文用一張表盤點它的 16 個核心工具講清三種代碼執(zhí)行模式與快速上手步驟幫助新手快速理解 AI 驅動 FreeCAD 的完整鏈路。一、FreeCAD MCP 是什么兩個組件 一條通信通道 整個系統(tǒng)由兩部分組成各司其職組件位置職責FreeCAD 端插件Addonaddon/FreeCADMCP/運行在 FreeCAD 內部提供工作臺與 RPC Server默認監(jiān)聽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 狀態(tài)欄會顯示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創(chuàng)建對象支持 Part、PartDesign、Fem 等類型?5對象操作edit_object修改對象的屬性?6對象操作delete_object刪除對象?7對象操作get_objects獲取文檔中所有對象?8對象操作get_object獲取單個對象的屬性詳情?9視圖檢查get_view獲取當前視圖截圖9 種視角可指定尺寸?10代碼執(zhí)行execute_code在 FreeCAD GUI 線程執(zhí)行 Python默認 90 秒預算?11代碼執(zhí)行execute_code_async后臺線程跑重計算用commit()回寫文檔?12代碼執(zhí)行get_async_status查詢后臺任務狀態(tài)與失敗堆棧?13代碼執(zhí)行execute_code_headless在獨立freecadcmd進程中跑腳本崩潰不影響 GUI?14健康檢查get_rpc_status報告 RPC/GUI 調度健康狀態(tài)與版本一致性?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。三、三種代碼執(zhí)行模式新手最需要理解的機制?execute_code只是入口真正體現工程設計的是三種執(zhí)行模式的分層詳解見 docs/execution.md工具運行位置適用場景execute_codeFreeCAD GUI 主線程常規(guī)建模自動化默認 90 秒隊列 執(zhí)行雙預算慢任務可傳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容器上自動創(chuàng)建SolverCcxTools并運行 CalculiX 求解器返回最大 von Mises 應力MPa、最大/最小位移mm、節(jié)點數與求解工作目錄默認超時 600 秒。配合create_object依次創(chuàng)建幾何、Fem::MaterialCommon材料、Fem::FemMeshGmsh網格和約束后整個分析閉環(huán)都在對話里完成。項目提供了端到端示例examples/cantilever_fem.py構建懸臂梁、跑 CalculiX并與解析解對比驗證。五、實戰(zhàn)演示自然語言 → 三維零件 三個官方演示覆蓋了 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目錄復制到你系統(tǒng)的 FreeCAD 插件目錄最終形成Mod/FreeCADMCP各平臺的目錄路徑與復制命令見 docs/installation.md。第 2 步啟動 RPC 服務重啟 FreeCAD → 選擇MCP Addon工作臺 → 點擊工具欄Start RPC Server狀態(tài)欄出現監(jiān)聽地址即成功?？稍?FreeCAD MCP 菜單中勾選Auto-Start Server實現開機自啟。第 3 步接入 AI 客戶端在 Claude Desktop 的claude_desktop_config.json中加入{ mcpServers: { freecad: { command: uvx, args: [freecad-mcp] } } }重啟客戶端對 AI 說一句創(chuàng)建一個邊長 10 的方盒子FreeCAD 里就會出現這個盒子。七、連接遇到問題用健康檢查工具自救 排障三板斧get_rpc_status報告 RPC 連通性、GUI 調度健康狀態(tài)以及插件與 Server 的版本一致性version_check為 ok 或提示哪一側需要更新查看 Report View 的啟動日志端口被占用等失敗原因會直接顯示例如核對兩側版本插件與freecad-mcp包獨立更新版本不一致時每次工具響應開頭會帶警告告訴你該更新哪一側若 GUI 線程卡死stuck按 docs/execution.md 的Recover from a stuck GUI operation章節(jié)處理必要時重啟 FreeCAD。其他高頻問題遠程連接RPC 服務默認只監(jiān)聽 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 全流程三種執(zhí)行模式兼顧了安全性與性能再加上截圖反饋AI 能看、能做、能查錯。裝好插件、連上客戶端你就可以像布置工作一樣對 FreeCAD 說話了。 延伸閱讀安裝指南 · 配置說明 · 工具清單 · 代碼執(zhí)行詳解 · 演示與示例【免費下載鏈接】freecad-mcpFreeCAD MCP(Model Context Protocol) server項目地址: https://gitcode.com/gh_mirrors/fr/freecad-mcp創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考