FreeCAD MCP — ИИ-агент в параметрическом CAD
FreeCAD MCP (blwfish)
MCP-мост между агентом и FreeCAD: 41 инструмент для параметрических деталей, CAM-траекторий, сеток и диагностики модели
- 66 ★ репозитория
- Последний коммит
- LGPL-2.1
Широкий доступ
Почему такой уровень
- Инструмент с произвольным Python дает агенту доступ к файловой системе и ОС через окружение FreeCAD
- Содержимое открытых файлов FreeCAD попадает в контекст агента: файл из ненадежного источника может нести вредные инструкции
Установка
- Работает в
Ручная установка
Go to https://github.com/blwfish/freecad-mcp and read the AGENT-INSTALL.md file. Follow the instructions to install and configure the FreeCAD MCP server on this machine.
Подсказка для агента из README: он сам ставит верстак, зависимости и регистрирует сервер.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Инструмент с произвольным Python дает агенту доступ к файловой системе и ОС через окружение FreeCAD
- Содержимое открытых файлов FreeCAD попадает в контекст агента: файл из ненадежного источника может нести вредные инструкции
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект состоит из двух частей: верстака AICopilot, который запускает сокет-сервер внутри FreeCAD, и Python-моста, переводящего вызовы MCP в сообщения для этого сокета. Агент получает 41 инструмент для работы с запущенным FreeCAD: Part, PartDesign, Sketch, Draft, булевы операции, преобразования, измерения, сетки и CAM. Типичные задачи из README: собрать монтажную пластину по размерам, разобраться, почему не получается операция «pad» по эскизу, проверить толщину стенок перед печатью, спланировать фрезеровку кармана, превратить STL от производителя в деталь с креплениями. Отдельные инструменты читают Report View, показывают ограничения эскиза и пишут журнал операций с отчетами о сбоях ядра OCCT. Мост умеет работать с несколькими экземплярами FreeCAD: с окном и без окна, у каждого свой сокет и файл обнаружения. Агент видит список экземпляров, выбирает нужный по метке или UUID и может запустить новый.
Для кого. Конструкторам, фрезеровщикам с ЧПУ и тем, кто печатает детали на 3D-принтере и хочет вести работу во FreeCAD через диалог с агентом.
Подходит, если
- Деталь с размерами и отверстиями надо построить по описанию и довести до рабочей модели
- FreeCAD выдает непонятную ошибку при операции «pad» или внешней ссылке, и агент должен прочитать Report View
- Перед печатью или ЧПУ хочется проверить стенки, ошибки геометрии и столкновения деталей
- Для серии одинаковых кронштейнов нужен макрос, который строит их по таблице размеров
- Модель надо отдать в производство как STEP и получить G-code для фрезера
Не подходит, если
- Нужна работа со FreeCAD без запущенной программы: мост общается только с живым экземпляром с загруженным верстаком
- Файлы FreeCAD приходят из ненадежных источников: агент читает их содержимое и может выполнить встроенный код
- Достаточно простой скрипт на Python для FreeCAD: мост избыточен, если нет диалога с моделью
Пример запроса к агенту
Построй в открытом документе монтажную пластину 100x60 мм с четырьмя отверстиями M3 и скругленными углами, затем проверь толщину стенок.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Все инструменты, кроме CAM, рассчитаны на стабильный FreeCAD 1.1.x, для траекторий CAM нужна свежая еженедельная сборка. Автор разрабатывал на macOS вместе с Claude Code, Windows и Linux поддерживаются кодом, но проверены меньше. Пакет не опубликован в PyPI: зависимость mcp-agent-notes закреплена на коммите, установку ведет инструкция AGENT-INSTALL.md из репозитория. Клиенты с жестким лимитом числа инструментов могут не вместить все 41. Раз в сутки мост проверяет наличие нового релиза через публичный API GitHub и пишет это в локальный журнал.
Как отключить. Закройте FreeCAD или отключите верстак AICopilot в его менеджере дополнений и уберите запись freecad из конфигурации MCP-клиента. Клонированную папку проекта можно удалить, данные FreeCAD она не хранит.
Частые вопросы
Какая версия FreeCAD нужна?
Для всех инструментов кроме CAM подходит стабильная 1.1.x. Генерации траекторий CAM нужна свежая еженедельная сборка разработки, которую раньше называли 1.2-dev.
Что агент может сделать в системе через этот мост?
Инструмент с произвольным Python выполняет код внутри окружения FreeCAD, а значит имеет доступ к файловой системе и ОС. Автор называет это сознательным решением. Проверяйте, какие вызовы подтверждаете.
Можно ли подключить несколько окон FreeCAD?
Да. У каждого процесса свой UUID, сокет и файл обнаружения. Инструменты list_freecad_instances и select_freecad_instance показывают и выбирают экземпляр, spawn_freecad_instance запускает новый.
Работает ли мост не с Claude?
Автор проверял вручную через нативный MCP-клиент LM Studio с локальной моделью Qwen2.5 Coder 14B. Основной сценарий построен на Claude Code, патчи для других агентов приветствуются.
Чем помогает журнал диагностики?
Мост пишет журнал операций и сохраняет отчеты о сбоях ядра OCCT, после которых сам FreeCAD не оставляет следов. Руководство AGENT-DEBUGGING.md описывает порядок разбора для агента.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер САПР ClassCAD: агент строит детали и сборки скриптами, смотрит снимки и сохраняет STEP и STL
PartCAD хранит механические детали как текст: агент пишет CAD-скрипт, рендерит модель и сверяет ее с заданием.
MCP-сервер для геомеханики ITASCA: агент ищет в документации PFC, FLAC, 3DEC, MPoint и MassFlow и запускает модели
MCP-сервер для OpenSCAD: агент рендерит детали с известным масштабом, измеряет геометрию и ищет коллизии в сборках
agentcad дает ИИ-агенту 3D-проектирование: скрипты build123d, экспорт STEP, рендер, проверка геометрии, просмотр в браузере
MCP-сервер для CAD на build123d: агент строит деталь шагами, смотрит рендер, мерит геометрию и выгружает STEP и STL.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| FreeCAD MCP — ИИ-агент в параметрическом CAD (эта карточка) | нет | не нужна | 66 | |
| FreeCAD MCP | нет | не нужна | 3 310 | другая реализация FreeCAD MCP, не этот мост с верстаком AICopilot |
| KiCad MCP Pro | нет | не нужна | 212 | проектирование печатных плат в KiCad, механическая модель не затрагивается |
Коротко о README
README подает проект как партнера по дизайну: человек задает замысел, агент берет на себя механику FreeCAD. Приведены два разобранных сценария, отладка внешней ссылки и генератор черепицы по таблице параметров, а также раздел о безопасности и тестах.