FreeCAD MCP

这是一个 FreeCAD MCP，允许你从 Claude Desktop 控制 FreeCAD。

演示

设计法兰

设计玩具车

根据 2D 图纸设计零件

输入 2D 图纸

演示

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

Related MCP server: FreeCAD MCP

安装插件

FreeCAD 插件目录为

• Windows: %APPDATA%\FreeCAD\Mod\

• Mac:

  • FreeCAD 1.1: ~/Library/Application\ Support/FreeCAD/v1-1/Mod/

  • FreeCAD 1.0: ~/Library/Application\ Support/FreeCAD/v1-0/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

# For Linux (Ubuntu/Debian)
cp -r addon/FreeCADMCP ~/.FreeCAD/Mod/

# For macOS (FreeCAD 1.1)
cp -r addon/FreeCADMCP ~/Library/Application\ Support/FreeCAD/v1-1/Mod/

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

你可以通过“FreeCAD MCP”工具栏中的“Start RPC Server”命令启动 RPC 服务器。

自动启动 RPC 服务器

默认情况下，RPC 服务器必须在每次打开 FreeCAD 时手动启动。要自动启动它：

1. 打开 FreeCAD MCP 菜单（先切换到 MCP Addon 工作台）

2. 勾选 Auto-Start Server

设置将保存到 freecad_mcp_settings.json 中，并在会话间保持。下次启动 FreeCAD 时，RPC 服务器将在应用程序加载完成后自动启动。

你可以随时通过在同一菜单中取消勾选 Auto-Start Server 来禁用它。

设置 Claude Desktop

需要预先安装 uvx。

并且你需要编辑 Claude Desktop 配置文件 claude_desktop_config.json。

对于用户。

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

如果你想节省 token，可以将 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"
      ]
    }
  }
}

远程连接

默认情况下，RPC 服务器不接受远程连接，仅监听 localhost。要从网络上的另一台机器控制 FreeCAD：

1. 在 FreeCAD 中启用远程连接

在 FreeCAD MCP 工具栏中：

1. 勾选 Remote Connections — RPC 服务器将在下次重启时绑定到 0.0.0.0（所有接口）。出于安全考虑，它仅接受来自 Allowed IPs 字段中指定的 IP 地址或 CIDR 子网的连接。默认值为 127.0.0.1。

2. 点击 Configure Allowed IPs 并输入以逗号分隔的允许连接的 IP 地址或 CIDR 子网列表，例如：

   192.168.1.100, 10.0.0.0/24

   127.0.0.1 始终是默认值。无效条目将被拒绝并显示错误对话框。更改这些设置后，请重启 RPC 服务器。

2. 将 MCP 服务器指向远程主机

传入 --host 标志，后跟运行 FreeCAD 的机器的 IP 地址或主机名：

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

--host 值会在启动时进行验证 — 它必须是有效的 IPv4/IPv6 地址或主机名。

工具

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

贡献者

由 contrib.rocks 制作。