FreeCAD MCP

Этот репозиторий представляет собой FreeCAD MCP, который позволяет управлять FreeCAD из Claude Desktop.

Демонстрация

Проектирование фланца

Проектирование игрушечного автомобиля

Проектирование детали по 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/ (если вы установили FreeCAD через snap)

  • 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" из списка верстаков (Workbench) и использовать его.

Вы можете запустить RPC-сервер с помощью команды "Start RPC Server" на панели инструментов "FreeCAD MCP".

Автозапуск 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"
      ]
    }
  }
}

Если вы хотите сэкономить токены, вы можете установить 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 (всем интерфейсам). В целях безопасности он принимает подключения только с IP-адресов или подсетей CIDR, указанных в поле Allowed IPs. По умолчанию это 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 с IP-адресом или именем хоста компьютера, на котором запущен FreeCAD:

{
  "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: Выполнить произвольный код Python во FreeCAD.

• insert_part_from_library: Вставить деталь из библиотеки деталей.

• get_view: Получить скриншот активного вида.

• get_objects: Получить все объекты в документе.

• get_object: Получить объект в документе.

• get_parts_list: Получить список деталей из библиотеки деталей.

Участники

Создано с помощью contrib.rocks.