66 lines
5.0 KiB
Markdown
66 lines
5.0 KiB
Markdown
# КОМПАС-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) 10 или новее, x64** — сервер
|
|
поставляется framework-dependent (2,3 МБ вместо 34), поэтому рантайм берётся с машины.
|
|
Проверить: `dotnet --list-runtimes` должен показать `Microsoft.NETCore.App 10.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`** | 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 и opencode — сниппеты конфигурации лежат в
|
|
`plugin/adapters/{codex,opencode}/`.
|
|
|
|
## Лицензия
|
|
|
|
MIT — см. [LICENSE](LICENSE). На interop-сборки КОМПАС-3D (© АО «АСКОН») лицензия не
|
|
распространяется: они в поставку не входят.
|