КОМПАС-3D в Claude Code

Каталог плагинов с одним плагином — kompas. Он даёт Claude Code управление КОМПАС-3D (АСКОН) через MCP-сервер: детали, эскизы, формообразующие операции, массивы и зеркало, отверстия, сборки с сопряжениями, 2D-чертежи, STEP/STL, осмотр и измерение модели — плюс два навыка с методикой построения.

Это репозиторий поставки: здесь лежит собранный сервер и материалы плагина. Исходники сервера не публикуются.

Что нужно до установки

• Windows x64 — сервер является COM-клиентом КОМПАС и работает только на той же машине;
• установленный КОМПАС-3D (проверено на v24 Home) с компонентом SDK. Interop-сборки принадлежат АСКОН, в поставку не входят и берутся из установки (SDK\Samples\CSharp.zip, каталог Common); при первом запуске они распаковываются в %LOCALAPPDATA%\kompas-mcp\interop\<ключ>. Если SDK не установлен, укажите каталог с этими сборками в переменной окружения KOMPAS_INTEROP_DIR;
• .NET Runtime 8 или новее, x64 — сервер поставляется framework-dependent (2,3 МБ вместо 34), поэтому рантайм берётся с машины. Проверить: dotnet --list-runtimes должен показать Microsoft.NETCore.App 8.x или новее;
• чекаут и рабочие файлы — вне синхронизируемых папок OneDrive.

Запускать КОМПАС заранее не нужно: сервер присоединится к открытому окну, а если его нет — запустит экземпляр сам.

Установка

/plugin marketplace add https://git.shahovalov.ru/mikhail/kompas-plugin.git
/plugin install kompas@kompas-plugin
/kompas:doctor

/kompas:doctor — диагностика: версия сервера, установлен ли КОМПАС, на месте ли interop-сборки, проходит ли соединение. С неё стоит начинать разбор любой неполадки.

Обновление

/plugin marketplace update kompas-plugin
/plugin update kompas@kompas-plugin

Если после обновления инструменты остались прежними — /reload-plugins.

Что внутри

MCP-сервер kompas	85 инструментов: документы, эскизы, выдавливание/вращение/по сечениям/по траектории, оболочка, рёбра, уклон, скругления и фаски, массивы и зеркало, отверстия, булевы операции, прямое редактирование B-rep, переменные и параметризация, сборки и сопряжения, 2D-чертежи (виды, размеры, обозначения, тех. требования), STEP/STL, осмотр (describe_model, list_faces, list_edges, measure)
Навык kompas-3d	методика построения: порядок работы, выбор подхода, проверенные приёмы и ловушки
Навык kompas-fdm-design	проектирование под FDM/FFF-печать: нависания, толщины стенок, зазоры и посадки, ориентация, бобышки и защёлки
Команда /kompas:doctor	диагностика установки
Справка help	инструмент help(topic=…) — статьи по механике и ловушкам, прямо в сессии

Другие агентские харнессы

Тот же сервер подключается к Codex и opencode — сниппеты конфигурации лежат в plugin/adapters/{codex,opencode}/.

Лицензия

MIT — см. LICENSE. На interop-сборки КОМПАС-3D (© АО «АСКОН») лицензия не распространяется: они в поставку не входят.