FreeCAD MCP — MCP-сервер для Claude Code: что делает и как установить
Связывает ИИ-агента с САПР FreeCAD для параметрического 3D-моделирования, расчёта траекторий ЧПУ и исправления ошибок в эскизах.
claude mcp add freecad-mcp -- docker run -i --rm ghcr.io/blwfish/freecad-mcp:latestЧто делает FreeCAD MCP
Сервер даёт агенту доступ к FreeCAD через сокетное соединение и надстройку AICopilot. Ассистент создаёт геометрию в PartDesign, проверяет ограничения эскизов, читает панель отчётов и находит причины поломки внешних связей. Доступен экспорт деталей в STEP и генерация G-кода для фрезеров.
Архитектура поддерживает запуск нескольких экземпляров FreeCAD одновременно. Процессы регистрируют свои сокеты в каталоге ~/.cache/freecad-mcp/instances/, а агент переключается между ними с помощью инструмента select_freecad_instance по UUID или метке.
Для траекторий CAM стабильной версии FreeCAD 1.1.x недостаточно: из-за изменений API верстака Path генерация фрезерных путей требует еженедельной сборки программы.
Какие задачи решает
- Спроектировать деталь по точным размерам в PartDesign
- Найти причину ошибки при выдавливании эскиза через Report View
- Сгенерировать G-код и траектории фрезерования для ЧПУ
- Преобразовать импортированную сетку STL в твёрдое тело с крепежом
- Экспортировать готовую сборку в формат STEP
Примеры запросов агенту
- Построй монтажную пластину 100х60 мм со скруглёнными углами и четырьмя отверстиями M3
- Посмотри Report View во FreeCAD и объясни, почему ломается выдавливание эскиза
- Подготовь траектории обработки кармана для фрезера и выгрузи G-код
Как установить FreeCAD MCP
Командой платформы
claude mcp add freecad-mcp -- docker run -i --rm ghcr.io/blwfish/freecad-mcp:latestКомандой платформы
codex mcp add freecad-mcp -- docker run -i --rm ghcr.io/blwfish/freecad-mcp:latestФайл настроек
{
"mcpServers": {
"freecad-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/blwfish/freecad-mcp:latest"
]
}
}
}Файл настроек
{
"servers": {
"freecad-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/blwfish/freecad-mcp:latest"
]
}
}
}Командой платформы
gemini mcp add freecad-mcp docker run -i --rm ghcr.io/blwfish/freecad-mcp:latestПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о FreeCAD MCP
Как установить FreeCAD MCP в Claude Code?
Выполните команду регистрации контейнера: claude mcp add freecad-mcp -- docker run -i --rm ghcr.io/blwfish/freecad-mcp:latest. Дополнительно внутри самого FreeCAD должен быть установлен и загружен верстак AICopilot.
Что делает FreeCAD MCP?
Предоставляет более 30 инструментов для создания 3D-моделей, отладки эскизов, манипуляций с полигональными сетками и подготовки управляющих программ ЧПУ прямо в рабочей сессии FreeCAD.
Какая версия FreeCAD требуется для работы?
Инструменты моделирования поддерживают стабильную ветку FreeCAD 1.1.x. Для генерации CAM-траекторий требуется актуальная еженедельная сборка разработки из-за смены внутреннего API верстака Path.
