MCP-СЕРВЕР ДЛЯ КОМПАС-3D · ВЕРСИЯ 1.3.6

КОМПАС-3D, которым управляет ИИ-агент

Kompas-MCP соединяет ИИ-агента с установленным КОМПАСом: агент создаёт детали, эскизы, сборки и чертежи, а сервер перечитывает модель и отвечает тем, что получилось на самом деле, — а не тем, что «вызов прошёл».

Windows x64 — версия 1.3.6 · КОМПАС-3D v25 · 57 инструментов

Двигатель V6: сборка из 37 компонентов, построенная агентом через MCP

ПОЧЕМУ 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

Агент сам смотрит на модель и показывает, что построил

KOMPAS_SET_MODEL_VIEW + KOMPAS_EXPORT_IMAGE

Агент сам смотрит на модель — с любой стороны

Изометрия · isoset_model_view(orientation="iso")
Сверху · topset_model_view(orientation="top")
Спереди · frontset_model_view(orientation="front")
Справа · rightset_model_view(orientation="right")
Другой ракурс · iso_yset_model_view(orientation="iso_y")

KOMPAS_PATTERN_CIRCULAR

Одно отверстие → шесть, одним вызовом

До · исходный элементextrude(feature_kind="cut") # Ø8 на R33
После · круговой массивpattern_circular(axis="z", count=6, step=60)

объём 76 843,4 → 74 330,1 мм³ · −5 × 502,65 мм³ · verification: geometry_checked (пять копий отверстия Ø8)

KOMPAS_ADD_COMPONENT

Сборка на 37 компонентов — тоже агент

37
компонентов в сборке из 14 деталей
поршни, шатуны, катушки, патрубки — по шесть копий одного файла
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». Сервер работает, пока открыто окно.

{
  "mcpServers": {
    "kompas": { "url": "http://localhost:8770/mcp" }
  }
}

Клиент без HTTP-транспорта запускает сервер сам — путь к нему установщик пишет в mcp-config.snippet.json рядом с KompasMcp.Server.exe:

{
  "mcpServers": {
    "kompas": { "command": "%LOCALAPPDATA%\\KompasMcp\\bin\\KompasMcp.Server.exe", "args": [] }
  }
}

Первый запрос агенту — в окне сервера, раздел «Примеры промптов».

Скачайте Kompas-MCP — и дайте агенту КОМПАС

Скачать для Windows