Kompas-MCP соединяет ИИ-агента с установленным КОМПАСом: агент создаёт детали, эскизы, сборки и чертежи, а сервер перечитывает модель и отвечает тем, что получилось на самом деле, — а не тем, что «вызов прошёл».
Windows x64 — версия 1.3.6 · КОМПАС-3D v25 · 57 инструментов
ПОЧЕМУ KOMPAS-MCP
Не скрипт под одну задачу, а инструменты, которые агент понимает сам
Скрипт на pywin32 умеет то, что в нём написали, и молчит, когда что-то пошло не так. MCP-сервер описывает агенту каждое действие схемой, сам ставит КОМПАС в известное состояние и после каждой операции проверяет модель. Агент не угадывает API — он вызывает инструмент и получает измеренный результат.
57
инструментов с JSON-схемой: от эскиза и выдавливания до сборок, чертежей и STEP
перечень отдаёт kompas_capabilities
54 214
точек API КОМПАСа доступны агенту через шлюз kompas_call
API5 + API7, замер зондом
4
уровня проверки результата — от «вызов вернулся» до «геометрия совпала»
unverified_aspects перечисляет непроверенное
1
установщик: сервер, Worker, GUI и .NET внутри
один файл, .NET ставить не нужно
Агент видит, что умеет сервер
Каждый из 57 инструментов приходит агенту со строгой JSON-схемой: имя, параметры, типы, описание. Ошибку в аргументе сервер отвергает invalid_argument до КОМПАСа. Скрипт агенту приходится читать и угадывать, как его вызвать.
Ответ — то, что перечитано на модели
Коды возврата КОМПАСа недостоверны: замер на v25 — вырез создал признак, вернул Create() = true и не снял ни миллиметра материала. Сервер на такое отвечает operation_had_no_effect с объёмом до и после, а не ok.
Уровень проверки — call_returned, read_back, geometry_checked; выше того, что проверено, сервер не заявляет.
Мера — объём. Габарит не меняется при внутреннем вырезе, счётчик объектов на v25 возвращает ноль — объём чувствует и добавление, и удаление материала.
Числа сходятся с аналитикой: скругление ребра — 77.256661176918 мм³ при расчётных 77.2566611769186.
На большой модели — так же. При сборке V6 протяжка с дугой не в ту сторону вернула operation_had_no_effect, а не ok; агент развернул дугу, и следующий вызов построил патрубок.
Ошибка — с причиной и с тем, что делать дальше
Скрипт падает трассировкой COM. Сервер отвечает кодом и политикой повтора: stale_reference — ссылка на ребро устарела, перечитайте топологию; revision_conflict — модель изменилась с момента чтения; outcome_unknown — таймаут, повтор вслепую может применить операцию дважды; path_not_allowed — путь вне разрешённого каталога. Рядом — retry_policy: safe_to_retry, retry_after_reread, do_not_retry_blindly.
Повтор не испортит модель
Каждая мутация несёт operation_id и пишется в журнал до и после выполнения. Повтор с тем же operation_id не применяется второй раз; expected_revision отвергает правку устаревшей модели. В скрипте это пишут руками — или не пишут.
Зависший вызов не роняет сеанс
COM КОМПАСа живёт в отдельном процессе Worker: один STA-поток с очередью команд. Экспорт STEP или перестроение сборки длятся минутами и не отменяются; зависший Worker перезапускается, а агент сохраняет связь и узнаёт, какие документы стали недействительны. Скрипт в таком случае приходится убивать вместе с консолью.
Без хрупкости pywin32
КОМПАС отдаёт часть возможностей через вторичные интерфейсы и out-параметры. В Python это ломается тихо: позднее связывание не видит ViewProjectionManager, пока объект не приведён к IKompasDocument3D1; часть методов позднему связыванию не видна; makepy для КОМПАСа автоматически не генерируется. Сервер написан на C# против interop-сборок: ошибка в имени члена ловится при компиляции, а не у пользователя.
Чужие файлы в безопасности
Каталоги — роли: откуда агент читает модели, куда пишет свои, куда выгружает STEP, STL, DXF и снимки. Задан корень — путь вне него отклоняется path_not_allowed до обращения к КОМПАСу; корень записи не может совпасть с корнем чтения. Пользовательский КОМПАС сервер не закрывает никогда, открытые вручную документы — только по явному adopt.
Работает с любым MCP-клиентом
Один и тот же сервер подключается к любому клиенту с поддержкой MCP: по command (stdio) или по URL http://localhost:8770/mcp, пока запущен GUI. Скрипт привязан к тому, кто его написал, и к той машине, где он лежит.
Возможность
Kompas-MCP
Скрипт на Python
Описание действий для агента (JSON-схема)
✓
—
Проверка результата перечитыванием модели
✓
частично
Отказ «нет эффекта» вместо ложного успеха
✓
—
Коды ошибок с политикой повтора
✓
—
Защита от повтора и устаревшего состояния
✓
—
Восстановление после зависшего COM-вызова
✓
—
Ограничение путей записи и выгрузки
✓
частично
Установка одним файлом, без Python и .NET
✓
—
Доступ к любому члену API
✓ через kompas_call
✓
«Частично» — проверку и ограничение путей можно написать в скрипте самому; в Kompas-MCP они встроены в каждый инструмент. Доступ к длинному хвосту API есть у обоих: у скрипта — без ограничений, у сервера — через шлюз с журналом, ревизиями и запретом разрушающих маршрутов.
ЧТО УМЕЕТ СЕРВЕР
57 инструментов. Каждый подтверждает результат.
Детали с нуля
Эскиз, выдавливание, вращение, лофт, сдвиг по траектории, оболочка, зеркало, круговой массив — каждый признак подтверждается объёмом.
Скругления и фаски
Рёбра адресуются ссылкой из топологии, а не номером по порядку; снятый материал сверяется с аналитикой.
Правка готовых моделей
Сервер видит документы, открытые вручную, принимает их и правит эскизы, плоскости и признаки.
Сборки
Компоненты из файлов, поворот и перестановка, сопряжения по плоскостям — положение доказывается перечиткой.
Чертежи
Стандартные виды, линейные, диаметральные и угловые размеры, основная надпись и техтребования; выгрузка в DXF и растр.
Выгрузка и снимки
STEP, STL, картинки модели с нужного ракурса — 13 видов и свой up-vector.
Справка SDK внутри
Поиск по офлайн-справке, которую поставляет КОМПАС: агент читает сигнатуру, а не вспоминает её.
СНИМКИ ЖИВОГО ПРОГОНА · V1.3.5
Агент сам смотрит на модель и показывает, что построил
поршни, шатуны, катушки, патрубки — по шесть копий одного файла
150,0
мм — длина каждого из шести шатунов
положение считается из угла коленвала
803
вызова MCP на первую версию, ~15 минут
ещё 817 — на реалистичный корпус и цвета, ~23 минуты
1
вырез, который КОМПАС назвал успехом, а сервер — нет
operation_had_no_effect: «Create() вернул True, но объём тела не изменился»
Двигатель V6 · iso_yБлок, головки, впуск, выпуск, коленвал — 37 компонентов, все построил агент.Без головкиГоловка снята: поршень первого цилиндра в верхней мёртвой точке.
V6 спередиset_model_view(orientation="iso_z")Гнутые патрубки — сдвигом по траектории, цвета — из материалов в файлах деталей.Развал 60°set_model_view(orientation="left")Два банка под ±30°, выпускные коллекторы по бокам, ресивер в развале.Что внутриТри шатунные шейки через 120°, на каждой — два шатуна. Длина каждого шатуна — ровно 150 мм.
Живой прогон v1.3.5, КОМПАС-3D v25. Цветные снимки сняты через COM: kompas_export_image в 1.3.5 отдаёт растр в оттенках серого.
GUI-ХОСТ И УСТАНОВЩИК
Одно окно вместо догадок
СерверСтатус и URL для агента, подключённые агенты, журнал вызовов, примеры промптов и каталоги записи — в одном окне.УстановкаМастер находит КОМПАС, ставит сервер в выбранный каталог, проверяет его и создаёт ярлык на рабочем столе.
ПОДКЛЮЧЕНИЕ АГЕНТА
Подключить агента — одна строка в конфиге
Запустите Kompas-MCP с ярлыка на рабочем столе и скопируйте URL кнопкой «Копировать URL». Сервер работает, пока открыто окно.