【技术文档摘要】：

FreeCAD MCP

此仓库是一个 FreeCAD MCP，允许您从 Claude Desktop 控制 FreeCAD。

演示

设计一个法兰

设计一个玩具车

根据二维图纸设计零件

输入二维图纸

演示

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

安装插件

FreeCAD 插件目录是

• Windows: %APPDATA%\FreeCAD\Mod\
• Mac: ~/Library/Application\ Support/FreeCAD/Mod/
• Linux:
  • Ubuntu: ~/.FreeCAD/Mod/ 或 ~/snap/freecad/common/Mod/（如果您通过 snap 安装 FreeCAD）
  • Debian: ~/.local/share/FreeCAD/Mod

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

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

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

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

设置 Claude Desktop

需要预先安装 uvx。

您还需要编辑 Claude Desktop 配置文件 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: 获取 零件库 中的零件列表。

贡献者

<a href="https://github.com/neka-nat/freecad-mcp/graphs/contributors"> <img src="https://contrib.rocks/image?repo=neka-nat/freecad-mcp" /> </a>

由 contrib.rocks 制作。