FreeCAD·neka-nat
FreeCAD MCP — подключение и инструкция
FreeCAD MCP позволяет агенту читать документы FreeCAD, создавать и редактировать модели, выполнять Python и работать с FEM-сценариями.
Что умеет этот сервер
FreeCAD MCP позволяет агенту читать документы FreeCAD, создавать и редактировать модели, выполнять Python и работать с FEM-сценариями.
Связка состоит из FreeCAD-addon с RPC-сервером и MCP-процесса, запускаемого клиентом.
Сначала прочитай состав документа.
Задача для знакомства
Через 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.
- 01
Подготовь окружение
FreeCAD, uv/uvx и совместимый MCP-клиент. Нужен открытый тестовый документ FreeCAD и установленный addon FreeCADMCP.
- 02
Установи и настрой
Скачай репозиторий, скопируй addon/FreeCADMCP в каталог addons FreeCAD по инструкции своей ОС и перезапусти приложение. Выбери MCP Addon workbench и нажми Start RPC Server. В клиенте добавь uvx с аргументом freecad-mcp.
- 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-серверов Нейролюба.