FreeCAD MCP

这是一个允许从Claude桌面控制FreeCAD的FreeCAD MCP。

演示

设计一个法兰

设计一辆玩具车

从2D图纸设计零件

输入2D图纸

演示

这是对话历史。 https://claude.ai/share/7b48fd60-68ba-46fb-bb21-2fbb17399b48

安装插件

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