Freecad MCP

🚀 FreeCAD MCP

FreeCAD MCP是一款強大的工具，它允許用戶通過Claude桌面來控制FreeCAD，為FreeCAD的使用帶來了更多的便捷性和靈活性。

🚀 快速開始

演示

設計一個法蘭

設計一輛玩具車

從2D圖紙設計零件

輸入2D圖紙

演示

這是對話歷史：點擊查看

📦 安裝指南

安裝插件

FreeCAD的Addon目錄位置如下：

• Windows: %APPDATA%\FreeCAD\Mod\
• Mac: ~/Library/Application Support/FreeCAD/Mod/
• Linux: ~/.FreeCAD/Mod/ 或 ~/snap/freecad/common/Mod/（如果你從snap安裝了FreeCAD）

請將 addon/FreeCADMCP 目錄複製到Addon目錄中，可按以下命令操作：

git clone https://github.com/neka-nat/freecad-mcp.git
cd freecad-mcp
cp -r addon/FreeCADMCP ~/.FreeCAD/Mod/

安裝插件後，需要重新啟動FreeCAD。你可以在“工作臺”列表中選擇“MCP Addon”並使用它。

然後通過“開始RPC服務器”命令在“FreeCAD MCP”工具欄中啟動RPC服務器。

設置Claude桌面

編輯 claude_desktop_config.json 文件。

對於普通用戶

{
  "mcpServers": {
    "freecad": {
      "command": "uvx",
      "args": [
        "freecad-mcp"
      ]
    }
  }
}

如果你想保存令牌，可以將 only_text_feedback 設置為 true 並僅使用文本反饋。

{
  "mcpServers": {
    "freecad": {
      "command": "uvx",
      "args": [
        "freecad-mcp",
        "--only-text-feedback"
      ]
    }
  }
}

對於開發者

首先，你需要克隆此倉庫：

git clone https://github.com/neka-nat/freecad-mcp.git

然後進行如下配置：

{
  "mcpServers": {
    "freecad": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/freecad-mcp/",
        "run",
        "freecad-mcp"
      ]
    }
  }
}

✨ 主要特性

本工具提供了以下實用的功能：

• create_document：在FreeCAD中創建一個新文檔。
• create_object：在FreeCAD中創建一個新的對象。
• edit_object：編輯FreeCAD中的一個對象。
• delete_object：刪除FreeCAD中的一個對象。
• execute_code：在FreeCAD中執行任意Python代碼。
• insert_part_from_library：從部件庫插入一個部件。
• get_view：獲取活動視圖的屏幕截圖。
• get_objects：獲取文檔中的所有對象。
• get_object：獲取文檔中的一個對象。
• get_parts_list：獲取部件庫中的部件列表。