12 KiB
Плагин, который сажает языковую модель за кульман КОМПАС-3D: она строит детали, собирает сборки,
оформляет чертежи — и сама проверяет, что получилось именно то, о чём просили.
Claude Code · Codex · pi · opencode
КОМПАС-3D v24 / v25 · Windows x64 · .NET 10 · что нового
Установка · Что умеет · Что внутри · Если что-то не работает
kompas подключает агента к установленному КОМПАС-3D (АСКОН) через MCP-сервер. Агент не видит
интерфейса САПР: он работает с моделью через инструменты, а сервер переводит их в вызовы API КОМПАС
и отчитывается фактами, а не кодами возврата. Вместе с сервером приходят навыки с методикой построения.
Как это выглядит
Иллюстрация маршрута: агент сам выбирает инструменты, а методику ему подсказывает навык kompas-3d.
Что умеет
Чем отличается
- Успех проверяется, а не принимается на веру. КОМПАС умеет «успешно» вырезать мимо материала или выдавить не в ту сторону. Сервер сверяет результат с параметрами запроса и говорит прямо, когда вышло не то.
- Отказ называет причину. Не «ошибка построения #37», а «катет больше длины 20 из 54 рёбер:
[110]0.171 мм … возьмите меньше» или координаты разомкнутого конца контура. - Модель остаётся параметрической. Размеры связаны выражениями с переменными, и правка одной переменной перестраивает деталь — как у инженера, а не как у скрипта.
- Агенты не мешают друг другу. Режим
private(KOMPAS_MCP_INSTANCE=privateилиkompas_connect(instance="private")) поднимает собственный скрытый экземпляр КОМПАС, и параллельная сессия не уведёт активный документ. По умолчанию сервер работает в общем окне пользователя.
Установка
Что нужно заранее
| Windows x64 | сервер — COM-клиент КОМПАС и работает только на той же машине |
| КОМПАС-3D с компонентом SDK | проверено на v25 Home, v24 Home тоже поддерживается; запускать заранее не нужно — сервер присоединится к открытому окну или запустит экземпляр сам |
| .NET Runtime 10+, x64 | сервер поставляется framework-dependent, рантайм берётся с машины; dotnet --list-runtimes должен показать Microsoft.NETCore.App 10.x или новее |
| Папка вне OneDrive | клон и рабочие файлы не должны лежать в синхронизируемых папках |
Interop-сборки принадлежат АСКОН и в поставку не входят. Они берутся из установки
(SDK\Samples\CSharp.zip, каталог Common) и при первом запуске распаковываются в
%LOCALAPPDATA%\kompas-mcp\interop\<ключ>. Без SDK укажите каталог со сборками в
KOMPAS_INTEROP_DIR.
Claude Code
/plugin marketplace add https://git.shahovalov.ru/mikhail/kompas-plugin.git
/plugin install kompas@kompas-plugin
/kompas:doctor
Обновление:
/plugin marketplace update kompas-plugin
/plugin update kompas@kompas-plugin
Если после обновления инструменты остались прежними — /reload-plugins.
Codex
codex plugin marketplace add https://git.shahovalov.ru/mikhail/kompas-plugin.git
Затем откройте каталог плагинов Codex, выберите источник kompas-plugin, установите kompas и
начните новый чат. Обновление — codex plugin marketplace upgrade kompas-plugin, затем обновите
плагин в интерфейсе.
pi
Прилавок — pi-пакет целиком: расширение регистрирует MCP-сервер, оба навыка идут вместе.
pi install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git
Обновление — pi update --extensions; новые записи истории изменений pi покажет при
следующем запуске (при первой загрузке пакета — нет). Закрепить версию:
pi install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git@v0.7.5
Закреплённый тег сам не обновляется: повторите pi install с новым тегом или без него, чтобы снова
следовать ветке.
opencode и ручное подключение
Сниппеты конфигурации лежат в plugin/adapters/:
opencode, Codex,
pi. Все они запускают тот же сервер, что и плагин.
Что внутри
MCP-сервер kompas |
весь каталог инструментов; сервер едет в плагине, отдельно ставить нечего |
Навык kompas-3d |
методика построения: порядок работы, выбор подхода, проверенные приёмы и ловушки |
Навык kompas-fdm-design |
проектирование под FDM-печать: нависания, толщины стенок, зазоры и посадки, ориентация, бобышки и защёлки |
Справка help |
help(topic=…) — статьи по механике и ловушкам, прямо в сессии |
Команда /kompas:doctor |
диагностика установки в Claude Code |
Если что-то не работает
| Клиент | Проверка |
|---|---|
| Claude Code | /kompas:doctor — версия сервера, КОМПАС, interop-сборки, соединение |
| Codex, pi, opencode | инструмент kompas_status; ответ «Не подключено» значит, что сначала нужен kompas_connect |
| Инструментов нет совсем | сервер не запустился: проверьте dotnet --list-runtimes |
Это репозиторий поставки: здесь лежат собранный сервер и материалы плагина, исходники сервера не публикуются.
Лицензия
MIT — см. LICENSE. На interop-сборки КОМПАС-3D (© АО «АСКОН») лицензия не распространяется: они в поставку не входят.