FreeCAD·neka-nat

FreeCAD MCP — подключение и инструкция

FreeCAD MCP позволяет агенту читать документы FreeCAD, создавать и редактировать модели, выполнять Python и работать с FEM-сценариями.

ДизайнЛокальноБез ключа

Что умеет этот сервер

01

FreeCAD MCP позволяет агенту читать документы FreeCAD, создавать и редактировать модели, выполнять Python и работать с FEM-сценариями.

02

Связка состоит из FreeCAD-addon с RPC-сервером и MCP-процесса, запускаемого клиентом.

03

Сначала прочитай состав документа.

Задача для знакомства

Через FreeCAD MCP покажи объекты тестового документа и предложи простую параметрическую деталь по моим размерам. Не перезаписывай исходный файл.

Уточнить результат

Сверь размеры, параметры и дерево модели в FreeCAD. При ошибке связи проверь активность RPC Server и открытое приложение. Для расчёта проверь единицы и физические предпосылки.

Как подключить

Выберите подходящий способ

Подключить FreeCAD MCP

Скачай репозиторий, скопируй addon/FreeCADMCP в каталог addons FreeCAD по инструкции своей ОС и перезапусти приложение. Выбери MCP Addon workbench и нажми Start RPC Server. В клиенте добавь uvx с аргументом freecad-mcp.

Что понадобится

  • FreeCAD, uv/uvx и совместимый MCP-клиент. Нужен открытый тестовый документ FreeCAD и установленный addon FreeCADMCP.
  1. 01

    Подготовь окружение

    FreeCAD, uv/uvx и совместимый MCP-клиент. Нужен открытый тестовый документ FreeCAD и установленный addon FreeCADMCP.

  2. 02

    Установи и настрой

    Скачай репозиторий, скопируй addon/FreeCADMCP в каталог addons FreeCAD по инструкции своей ОС и перезапусти приложение. Выбери MCP Addon workbench и нажми Start RPC Server. В клиенте добавь uvx с аргументом freecad-mcp.

  3. 03

    Открой новую сессию

    Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.

Пример MCP-конфигурации на основе README

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

Первый запрос — пример для чата агента

Через FreeCAD MCP покажи объекты тестового документа и предложи простую параметрическую деталь по моим размерам. Не перезаписывай исходный файл.

Как проверить

Сверь размеры, параметры и дерево модели в FreeCAD. При ошибке связи проверь активность RPC Server и открытое приложение. Для расчёта проверь единицы и физические предпосылки.

Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.

README и установка автора

Что умеет FreeCAD

FreeCAD MCP позволяет агенту читать документы FreeCAD, создавать и редактировать модели, выполнять Python и работать с FEM-сценариями.

Связка состоит из FreeCAD-addon с RPC-сервером и MCP-процесса, запускаемого клиентом. По умолчанию соединение локальное; один установленный npm-пакет здесь не заменяет addon.

Что подготовить перед подключением

FreeCAD, uv/uvx и совместимый MCP-клиент. Нужен открытый тестовый документ FreeCAD и установленный addon FreeCADMCP.

Как установить и подключить

Скачай репозиторий, скопируй addon/FreeCADMCP в каталог addons FreeCAD по инструкции своей ОС и перезапусти приложение. Выбери MCP Addon workbench и нажми Start RPC Server. В клиенте добавь uvx с аргументом freecad-mcp.

Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.

Как пользоваться: первый сценарий

Сначала прочитай состав документа. Затем создай простую деталь по размерам и проверь её дерево построения. Для FEM нужны отдельные настройки материала, нагрузок и расчёта — их нельзя угадывать по картинке.

Как проверить результат и решить проблемы

Сверь размеры, параметры и дерево модели в FreeCAD. При ошибке связи проверь активность RPC Server и открытое приложение. Для расчёта проверь единицы и физические предпосылки.

Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.

Ограничения

Выполнение Python меняет документ, поэтому начинай с копии. Корректная геометрия не является доказательством прочности; FEM требует инженерной проверки входных данных.

Исходники и документация

Репозиторий: neka-nat/freecad-mcp. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.

Другие подключения — в каталоге MCP-серверов Нейролюба.

Вопросы о FreeCAD

FreeCAD MCP позволяет агенту читать документы FreeCAD, создавать и редактировать модели, выполнять Python и работать с FEM-сценариями.
Вернуться в библиотеку