КОМПАС-3D MCP — управление CAD через LLM

Возможности

Что умеет MCP-сервер

Инструменты сгруппированы вокруг живого инженерного цикла моделирования — от подключения к КОМПАС до построения и опроса детали.

🔌

Подключение к КОМПАС

Attach к запущенному или launch нового экземпляра по ProgID, переход на API7 через ksGetApplication7(), управление видимостью окна.

📄

Документы

Создание, открытие, сохранение и закрытие деталей, сборок, чертежей и фрагментов через IDocuments.

✏️

Эскизы

Эскиз на плоскости или грани, примитивы (линия, окружность, дуга, прямоугольник), безопасный цикл BeginEdit → EndEdit.

🧊

3D-операции

Выдавливание и вырез, вращение, перестроение. Управление направлением, глубиной и типом окончания (ksEndTypeEnum).

🎯

Выборка и запросы

Выбор грани точкой для следующего эскиза, перечисление тел и граней, массово-центровочные характеристики детали.

👁️

Зрение агента

Рендер модели в PNG прямо в память (resultArrayBytes) и возврат как image-контент MCP — агент видит результат и строит пошагово. Плюс set_view: ориентация и zoom-to-fit перед снимком.

🛟

Escape-hatch

Прямой вызов команд КОМПАС через ExecuteKompasCommand для того, что ещё не обёрнуто в типизированные инструменты.

Ядро сценария

Цикл «эскиз → операция → эскиз»

Главный пользовательский поток v1 — итеративное параметрическое моделирование с визуальной проверкой: рисуем профиль, превращаем в объём, смотрим на результат, выбираем грань, рисуем следующий профиль.

Документ

создать деталь (part)

→

Эскиз

на плоскости XOY, профиль

→

Выдавить

boss-операция → тело

→

04 👁

Снимок

агент видит результат

→

Выбрать грань

по точке на теле

→

Вырез

новый эскиз → cut

↻ Повторять со зрением — снимок → новая грань → новый эскиз → новая операция → снова снимок, пока деталь не готова

Прогресс

TODO проекта

Честный срез состояния: фундамент подготовки готов, реализация сервера — впереди.

Общий прогрессv2: грань · вращение · скругление/фаска · габариты · список граней · 18 тестов

Подготовка ГОТОВО

Исследование, документация и инструменты разработчика

✓Исследование SDK и COM API (API5/API7, паттерны подключения)
✓CLAUDE.md — гайд по репозиторию и API
✓Навигатор по справке: tools/kdoc.py + индекс на 26k стр.
✓Документ архитектуры docs/ARCHITECTURE.md
✓Выбор стека: .NET/C#, stdio, цикл «эскиз↔операция»
✓Решение о визуальной обратной связи (зрение агента, рендер в растр)

Фундамент v1 ГОТОВО

Скелет сервера и связь с КОМПАС

✓Спайки S1–S4: interop, подключение, STA, рендер
✓Решение Core/Host/Tests, Directory.Build.props, git
✓Маппинг перечислений (enum ↔ строка)
✓STA-диспетчер (выделенный поток, очередь задач)
✓MCP-хост на stdio, логи в stderr
✓Подключение по ProgID (attach/launch)

Инструменты v1 ГОТОВО

28 инструментов, отдаются по MCP-протоколу

✓System: connect · status · set_visible
✓Documents: create · open · save · save_as · close · active
✓Sketch: create · on_face (точка/индекс) · add line/circle/rectangle/axis · close
✓Features: extrude · revolve · fillet_edge/chamfer_edge 🆕 · rebuild
✓Vision: model_snapshot 👁️
✓Query: get_part_info · get_bounding_box · list_faces 🆕
Query: list_bodies · list_edges (далее)

Качество и поставка В РАБОТЕ

Тесты, сборка, интеграция с клиентом

✓Unit-тесты диспетчера (5) — без COM
✓Интеграционные тесты с КОМПАС (7): подключение, документы, снимок, цикл
✓Сквозной прогон по MCP-протоколу (tools/call → PNG)
✓Сборка kompas-mcp.exe, README с конфигом клиента
In-process тест MCP-клиента, релизный publish

Дорожная карта

После v1

Наращиваем покрытие API волнами — от простых операций к параметрике, черчению и сборкам.

v1 · готово ✓

Цикл моделирования

Документы, эскизы, выдавливание/вырез, снимок модели — работает

v2 · в работе

Операции и выборка

Эскиз на грани ✓ · вращение ✓ · скругление/фаска ✓ · список граней ✓ · далее: массивы

Параметрика

Переменные IVariable7, свойства IPropertyMng, формулы

2D-черчение

Виды, размеры, тексты, штриховки; спецификации

Сборки и экспорт

Компоненты, сопряжения, конвертеры (STEP), HTTP/SSE-транспорт

КОМПАС-3D MCP-сервер
управление CAD языком LLM