freecad-mcp

🚀 FreeCAD MCP

FreeCAD MCP是一款强大的工具，它允许用户通过Claude桌面对FreeCAD进行控制，为CAD设计工作带来了极大的便利。

🚀 快速开始

演示

设计一个法兰

设计一辆玩具车

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