100 lines
6.8 KiB
Markdown
100 lines
6.8 KiB
Markdown
# КОМПАС-3D в Claude Code, Codex и pi
|
|
|
|
Каталог плагинов с одним плагином — **`kompas`**. Он даёт Claude Code управление
|
|
[КОМПАС-3D](https://ascon.ru/products/7/) (АСКОН) через MCP-сервер: детали, эскизы,
|
|
формообразующие операции, массивы и зеркало, отверстия, сборки с сопряжениями, 2D-чертежи,
|
|
STEP/STL, осмотр и измерение модели — плюс два навыка с методикой построения.
|
|
|
|
Это репозиторий поставки: здесь лежит собранный сервер и материалы плагина. Исходники сервера
|
|
не публикуются.
|
|
|
|
## Что нужно до установки
|
|
|
|
- **Windows x64** — сервер является COM-клиентом КОМПАС и работает только на той же машине;
|
|
- **установленный КОМПАС-3D** (проверено на v25 Home, v24 Home тоже поддерживается) **с компонентом SDK**. Interop-сборки
|
|
принадлежат АСКОН, в поставку не входят и берутся из установки
|
|
(`SDK\Samples\CSharp.zip`, каталог `Common`); при первом запуске они распаковываются
|
|
в `%LOCALAPPDATA%\kompas-mcp\interop\<ключ>`. Если SDK не установлен, укажите каталог
|
|
с этими сборками в переменной окружения `KOMPAS_INTEROP_DIR`;
|
|
- **[.NET Runtime](https://dotnet.microsoft.com/download/dotnet) 10 или новее, x64** — сервер
|
|
поставляется framework-dependent (2,3 МБ вместо 34), поэтому рантайм берётся с машины.
|
|
Проверить: `dotnet --list-runtimes` должен показать `Microsoft.NETCore.App 10.x` или новее;
|
|
- чекаут и рабочие файлы — вне синхронизируемых папок OneDrive.
|
|
|
|
Запускать КОМПАС заранее не нужно: сервер присоединится к открытому окну, а если его нет —
|
|
запустит экземпляр сам.
|
|
|
|
## Установка в Claude Code
|
|
|
|
```
|
|
/plugin marketplace add https://git.shahovalov.ru/mikhail/kompas-plugin.git
|
|
/plugin install kompas@kompas-plugin
|
|
/kompas:doctor
|
|
```
|
|
|
|
`/kompas:doctor` — диагностика: версия сервера, установлен ли КОМПАС, на месте ли interop-сборки,
|
|
проходит ли соединение. С неё стоит начинать разбор любой неполадки.
|
|
|
|
## Обновление в Claude Code
|
|
|
|
```
|
|
/plugin marketplace update kompas-plugin
|
|
/plugin update kompas@kompas-plugin
|
|
```
|
|
|
|
Если после обновления инструменты остались прежними — `/reload-plugins`.
|
|
|
|
## Что внутри
|
|
|
|
| | |
|
|
|---|---|
|
|
| **MCP-сервер `kompas`** | 78 инструментов: документы, эскизы, выдавливание/вращение/по сечениям/по траектории, оболочка, рёбра, уклон, скругления и фаски, массивы и зеркало, отверстия, булевы операции, прямое редактирование 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
|
|
|
|
В терминале зарегистрируйте публичный каталог:
|
|
|
|
```powershell
|
|
codex plugin marketplace add https://git.shahovalov.ru/mikhail/kompas-plugin.git
|
|
```
|
|
|
|
Затем откройте каталог плагинов Codex, выберите источник `kompas-plugin` и установите `kompas`.
|
|
Откройте новый чат с плагином: сервер и оба навыка поставляются вместе. Для обновления каталога
|
|
используйте `codex plugin marketplace upgrade kompas-plugin`, затем обновите плагин в интерфейсе.
|
|
Команда `/kompas:doctor` относится к Claude Code; в Codex проверяйте подключение через `kompas_status`.
|
|
|
|
## Установка в pi
|
|
|
|
Прилавок — pi-пакет целиком: расширение регистрирует MCP-сервер, оба навыка идут вместе.
|
|
|
|
```
|
|
pi install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git
|
|
```
|
|
|
|
Обновление — `pi update --extensions`. После обновления новые записи из
|
|
[CHANGELOG.md](CHANGELOG.md) показываются при следующем новом запуске pi
|
|
(при первой загрузке пакета — нет).
|
|
|
|
Для закрепления версии:
|
|
|
|
```
|
|
pi install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git@v0.7.5
|
|
```
|
|
|
|
Закреплённый тег не обновляется до следующего релиза автоматически: повторите `pi install`
|
|
с новым тегом или без ref, чтобы снова следовать ветке. Проверка соединения — `kompas_status`.
|
|
|
|
## Другие агентские харнессы
|
|
|
|
Тот же сервер можно подключить вручную к Codex, opencode и pi — сниппеты конфигурации лежат в
|
|
`plugin/adapters/{codex,opencode,pi}/`.
|
|
|
|
## Лицензия
|
|
|
|
MIT — см. [LICENSE](LICENSE). На interop-сборки КОМПАС-3D (© АО «АСКОН») лицензия не
|
|
распространяется: они в поставку не входят.
|