FreeCAD Robust MCP Server
MCP-сервер подключает агента к FreeCAD для построения деталей, редактирования документов, запуска макросов и экспорта моделей.
- 265 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Агент выполняет произвольный Python и макросы с правами FreeCAD, меняет документы и записывает файлы на диск.
Установка
- Работает в
Ручная установка
pip install freecad-robust-mcpПервый командный способ README. Пакет и рабочая среда устанавливаются отдельно; опубликованная 0.6.x не получает новое сопряжение, описанное для текущих исходников.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент выполняет произвольный Python и макросы с правами FreeCAD, меняет документы и записывает файлы на диск.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
FreeCAD Robust MCP Server связывает ИИ-клиент с работающим FreeCAD через отдельное дополнение. Агент может создать документ, добавить геометрические объекты, изменить параметры детали и сохранить результат. Пользователь проверяет модель в FreeCAD или получает снимок вида, если приложение запущено с графическим интерфейсом. Есть операции эскизов, экспорта в STEP и STL, отмены изменений и работы с макросами. Помимо готовых инструментов сервер позволяет выполнить Python в контексте FreeCAD. Поэтому доступ распространяется не только на геометрию: запускать следует доверенные задания в отдельном рабочем проекте.
Для кого. Конструкторам деталей в FreeCAD, которые хотят поручать агенту повторяемое моделирование и проверять результат в рабочем документе.
Подходит, если
- По размерам из задания агент собирает параметрическую заготовку детали.
- После правки пользователь хочет получить снимок модели в нужном ракурсе.
- Готовую деталь требуется экспортировать в согласованный формат для дальнейшей обработки.
- Повторяемый сценарий моделирования удобно оформить доверенным макросом.
Не подходит, если
- Нельзя разрешать агенту выполнение Python с правами процесса FreeCAD.
- Ожидается изображение модели от полностью безоконного запуска.
- Сервер требуется открыть в сеть без поддерживаемой защищенной схемы подключения.
Пример запроса к агенту
Создай в новом документе заготовку по заданным размерам, покажи снимок и список объектов; экспорт выполни после проверки модели.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
FREECAD_MODE- Способ связи с FreeCAD, по умолчанию xmlrpc
Ограничения
Для внешнего сервера нужны FreeCAD не ниже 1.0.2 и Python не ниже 3.11; автор рекомендует FreeCAD 1.1.4 или новее из-за исправлений безопасности. Указанные в README опубликованные версии 0.6.x еще не поддерживают новое сопряжение: для него требуются сервер и дополнение из одной актуальной копии исходников. Встроенный режим доступен только на Linux; для macOS и Windows используйте внешнее соединение. Без графического интерфейса инструменты снимков и управления видом недоступны.
Как отключить. Остановите мост через рабочую среду FreeCAD и удалите сервер из ИИ-клиента. Проверьте сохраненные документы и созданные макросы перед удалением дополнения.
Частые вопросы
Достаточно установить Python-пакет?
Нет. Нужны также FreeCAD и совместимое дополнение моста; обычная установка пакета не запускает CAD-приложение.
Почему дополнения нет в Addon Manager?
Рабочая среда пока отсутствует в публичном каталоге дополнений. Установите ее по инструкции из репозитория, выбрав версию, совместимую с вашим сервером.
Какая кнопка запускает мост?
В рабочей среде Robust MCP Bridge нажмите Start MCP Bridge.
Почему запрос снимка вернул ошибку?
Для снимка нужен FreeCAD с графическим интерфейсом; в безоконном режиме такая операция недоступна.
Можно выгрузить модель для печати?
Да. Есть экспорт STL и 3MF; перед ним проверьте геометрию и параметры детали.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для управления FreeCAD из Claude Desktop и других клиентов: создание и правка моделей, запуск скриптов и FEM-анализ
MCP-сервер для AutoCAD, GstarCAD и ZWCAD: черчение, правка и запрос чертежа обычными словами
Onshape MCP строит CAD-модели по запросу в чате: эскизы, выдавливание, сборки с сопряжениями и экспорт в STEP или STL.
AutoCAD MCP Pro
autocad-mcp-pro
MCP-сервер для AutoCAD с сотнями инструментов: живой AutoCAD через COM или DXF без программы, с режимом экономии токенов
AutoCAD MCP
autocad-mcp
MCP-сервер для AutoCAD LT: агент рисует и правит чертежи через AutoLISP, а без AutoCAD пишет файлы DXF
Fusion 360 MCP
fusion360-mcp-server
MCP-сервер для Autodesk Fusion 360: агент строит эскизы и тела, правит параметры и выполняет команды в открытом проекте
Коротко о README
Внешний сервер поддерживает два локальных способа связи с FreeCAD. Защищенное удаленное подключение пока не реализовано; мост не следует открывать на все сетевые интерфейсы.