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

Каталог плагинов с одним плагином — **`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) 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`** | 86 инструментов: документы, эскизы, выдавливание/вращение/по сечениям/по траектории, оболочка, рёбра, уклон, скругления и фаски, массивы и зеркало, отверстия, булевы операции, прямое редактирование 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](LICENSE). На interop-сборки КОМПАС-3D (© АО «АСКОН») лицензия не
распространяется: они в поставку не входят.