FreeCAD MCP

此仓库是一个 FreeCAD MCP，允许你通过 Claude Desktop 控制 FreeCAD。

演示

设计法兰

设计玩具车

从2D图纸设计零件

输入2D图纸

演示

安装插件

FreeCAD 插件目录为：

• Windows: %APPDATA%\FreeCAD\Mod\
• Mac: ~/Library/Application Support/FreeCAD/Mod/
• Linux: ~/.FreeCAD/Mod/ 或 ~/snap/freecad/common/Mod/（如果你是从 snap 安装的 FreeCAD）

请将 addon/FreeCADMCP 目录放置到插件目录中。

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

安装插件后，你需要重启 FreeCAD。
你可以从工作台列表中选择 "MCP Addon" 并使用它。

然后，你可以通过 "FreeCAD MCP" 工具栏中的 "启动 RPC 服务器" 命令来启动 RPC 服务器。

设置 Claude Desktop

编辑 claude_desktop_config.json 文件。

对于用户。

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

对于开发者。
首先，你需要克隆此仓库。

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: 获取 零件库 中的零件列表。