gitea-actions
66 lines
4.7 KiB
Markdown
66 lines
4.7 KiB
Markdown
# КОМПАС-3D в Claude Code
|
||
|
||
Каталог плагинов с одним плагином — **`kompas`**. Он даёт Claude Code управление
|
||
[КОМПАС-3D](https://ascon.ru/products/7/) (АСКОН) через 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](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`** | 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](LICENSE). На interop-сборки КОМПАС-3D (© АО «АСКОН») лицензия не
|
||
распространяется: они в поставку не входят.
|