11 Commits
75 changed files with 1067 additions and 654 deletions

No files matched your search

+12
View File
@@ -0,0 +1,12 @@
{
"name": "kompas-plugin",
"plugins": [
{
"name": "kompas",
"source": { "source": "local", "path": "./plugin" },
"policy": { "installation": "AVAILABLE", "authentication": "ON_INSTALL" },
"category": "Productivity",
"interface": { "displayName": "КОМПАС-3D" }
}
]
}
+3 -1
View File
@@ -11,7 +11,9 @@
{
"name": "kompas",
"source": "./plugin",
"description": "Управление КОМПАС-3D из Claude Code: 74 MCP-инструмента (детали, эскизы, формообразующие операции, массивы, отверстия, исполнения, внешний вид, сборки и сопряжения, 2D-чертежи, STEP/STL, осмотр модели) и два навыка — построение (kompas-3d) и проектирование под FDM-печать (kompas-fdm-design).",
"homepage": "https://git.shahovalov.ru/mikhail/kompas-plugin",
"license": "MIT",
"description": "Управление КОМПАС-3D из Claude Code: MCP-сервер (детали, эскизы, формообразующие операции, массивы, отверстия, исполнения, внешний вид, сборки и сопряжения, 2D-чертежи, STEP/STL, осмотр модели) и два навыка — построение (kompas-3d) и проектирование под FDM-печать (kompas-fdm-design).",
"category": "productivity",
"keywords": ["cad", "kompas", "3d", "step", "mcp", "fdm"]
}
+30
View File
@@ -0,0 +1,30 @@
# Changelog
## [0.7.7]
- Локальный HTTP-сервер принимает только loopback-соединения, а браузерный
клиент обязан отправлять Origin собственного хоста (защита от DNS rebinding).
- COM-объекты теперь освобождаются в едином скоупе за STA-операцию (ComScope);
перестроены построение деталей, геометрические запросы и импорт чертежей —
меньше утечек RCW при ошибках.
- Уточнены JSON-RPC-ошибки, журнал операций и кэш каталога моделей панели агента.
- Витрина прилавка: README оформлен как основной, добавлен значок для Codex,
манифесты больше не ссылаются на закрытый репозиторий; общий assets/ копируется
в прилавок при релизе.
## [0.7.6]
- Исправлены инструкции закрепления pi-пакета: первый поддерживаемый тег — v0.7.5;
приведена полная команда установки и пояснено обновление закреплённых версий.
- Добавлен changelog пакета для показа изменений в pi после обновления.
- Добавлены проверки changelog перед публикацией и после анонимного клонирования прилавка.
- В CI добавлен smoke-тест загрузки расширения из перемещённого пакета с пробелами в пути
и проверки конфигурации MCP без запуска КОМПАС; импорт типа API сделан явно type-only.
## [0.7.5]
- Добавлена установка в pi через git-пакет публичного прилавка.
- Расширение подключает MCP-сервер КОМПАС-3D через общий PowerShell-лаунчер;
инструменты доступны по поиску (`deferred`).
- Вместе с пакетом поставляются навыки `kompas-3d` и `kompas-fdm-design`.
- Добавлен ручной адаптер pi для подключения сервера без установки пакета.
+139 -33
View File
@@ -1,63 +1,169 @@
# КОМПАС-3D в Claude Code
<p align="center"><img src="assets/banner.svg" alt="kompas — КОМПАС-3D в руках языковой модели" width="100%"></p>
Каталог плагинов с одним плагином — **`kompas`**. Он даёт Claude Code управление
[КОМПАС-3D](https://ascon.ru/products/7/) (АСКОН) через MCP-сервер: детали, эскизы,
формообразующие операции, массивы и зеркало, отверстия, сборки с сопряжениями, 2D-чертежи,
STEP/STL, осмотр и измерение модели — плюс два навыка с методикой построения.
<p align="center">
<b>Плагин, который сажает языковую модель за кульман КОМПАС-3D: она строит детали, собирает сборки,<br>
оформляет чертежи — и сама проверяет, что получилось именно то, о чём просили.</b>
</p>
Это репозиторий поставки: здесь лежит собранный сервер и материалы плагина. Исходники сервера
не публикуются.
<p align="center">
Claude Code · Codex · pi · opencode<br>
<sub>КОМПАС-3D v24 / v25 · Windows x64 · .NET 10 · <a href="CHANGELOG.md">что нового</a></sub>
</p>
## Что нужно до установки
<p align="center">
<a href="#установка"><b>Установка</b></a> ·
<a href="#что-умеет">Что умеет</a> ·
<a href="#что-внутри">Что внутри</a> ·
<a href="#если-что-то-не-работает">Если что-то не работает</a>
</p>
- **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.
---
Запускать КОМПАС заранее не нужно: сервер присоединится к открытому окну, а если его нет —
запустит экземпляр сам.
**`kompas`** подключает агента к установленному [КОМПАС-3D](https://ascon.ru/products/7/) (АСКОН) через MCP-сервер. Агент не видит
интерфейса САПР: он работает с моделью через инструменты, а сервер переводит их в вызовы API КОМПАС
и отчитывается фактами, а не кодами возврата. Вместе с сервером приходят навыки с методикой построения.
<p align="center"><img src="assets/flow.svg" alt="Агент вызывает инструменты kompas3d-mcp; сервер управляет КОМПАС-3D через COM и возвращает факты со сверкой" width="100%"></p>
## Как это выглядит
<p align="center"><img src="assets/example.svg" alt="Запрос «кронштейн 150×96×24, стойка 110 с отверстием Ø40, два крепёжных Ø11, высота стойки — переменной» → агент делает семь вызовов от document_create до describe_model → сервер отвечает: построение чистое, тел 1, габарит 150×96×110, переменная H ведёт высоту стойки" width="100%"></p>
<sub>Иллюстрация маршрута: агент сам выбирает инструменты, а методику ему подсказывает навык `kompas-3d`.</sub>
## Что умеет
<table>
<tr>
<td width="100" align="center"><img src="assets/icons/part.svg" width="64" height="64" alt=""><br><b>Детали</b></td>
<td>эскизы списком примитивов (включая текст в кривых), выдавливание, вращение, лофт, кинематика, отверстия, условная резьба, фаски, скругления, оболочка, ребро, массивы, зеркало, уклон, булевы операции</td>
</tr>
<tr>
<td width="100" align="center"><img src="assets/icons/param.svg" width="64" height="64" alt=""><br><b>Параметрика</b></td>
<td>размеры операций — выражения (<code>depth="wall*2"</code>), переменные модели, управляющие размеры эскиза, исполнения в одном файле</td>
</tr>
<tr>
<td width="100" align="center"><img src="assets/icons/assembly.svg" width="64" height="64" alt=""><br><b>Сборки</b></td>
<td>вставка компонентов с поворотом, семь типов сопряжений (в том числе по вспомогательным плоскостям и осям), фиксация, проверка пересечений (объём и зазор — на v25)</td>
</tr>
<tr>
<td width="100" align="center"><img src="assets/icons/drawing.svg" width="64" height="64" alt=""><br><b>Чертежи</b></td>
<td>стандартные виды, разрезы и сечения, размеры с допусками, шероховатость, выноски, штамп, технические требования, фрагменты</td>
</tr>
<tr>
<td width="100" align="center"><img src="assets/icons/import.svg" width="64" height="64" alt=""><br><b>Чужая геометрия</b></td>
<td>импорт STEP, IGES, Parasolid, STL, родных форматов NX/Creo/SolidWorks/Inventor/CATIA, DXF/DWG (STL приходит сеткой, не телом); прямая правка B-rep без дерева построения (часть операций — на v25)</td>
</tr>
<tr>
<td width="100" align="center"><img src="assets/icons/export.svg" width="64" height="64" alt=""><br><b>Выход</b></td>
<td>STEP (AP203/214/242) в другую САПР, STL в слайсер, PNG-снимок модели и растр чертежа; раскраска детали, тел, операций, граней и компонентов сборки — цвет, прозрачность, текстуры</td>
</tr>
<tr>
<td width="100" align="center"><img src="assets/icons/inspect.svg" width="64" height="64" alt=""><br><b>Осмотр</b></td>
<td>один вызов <code>describe_model</code> — дерево, тела, топология, масса, переменные, ошибки, состав сборки; измерение зазоров с двумя ближайшими точками</td>
</tr>
</table>
### Чем отличается
- **Успех проверяется, а не принимается на веру.** КОМПАС умеет «успешно» вырезать мимо материала
или выдавить не в ту сторону. Сервер сверяет результат с параметрами запроса и говорит прямо,
когда вышло не то.
- **Отказ называет причину.** Не «ошибка построения #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](https://dotnet.microsoft.com/download/dotnet) 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
```text
/plugin marketplace add https://git.shahovalov.ru/mikhail/kompas-plugin.git
/plugin install kompas@kompas-plugin
/kompas:doctor
```
`/kompas:doctor` — диагностика: версия сервера, установлен ли КОМПАС, на месте ли interop-сборки,
проходит ли соединение. С неё стоит начинать разбор любой неполадки.
Обновление:
## Обновление
```
```text
/plugin marketplace update kompas-plugin
/plugin update kompas@kompas-plugin
```
Если после обновления инструменты остались прежними — `/reload-plugins`.
### Codex
```powershell
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-сервер, оба навыка идут вместе.
```text
pi install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git
```
Обновление — `pi update --extensions`; новые записи [истории изменений](CHANGELOG.md) pi покажет при
следующем запуске (при первой загрузке пакета — нет). Закрепить версию:
```text
pi install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git@v0.7.5
```
Закреплённый тег сам не обновляется: повторите `pi install` с новым тегом или без него, чтобы снова
следовать ветке.
### opencode и ручное подключение
Сниппеты конфигурации лежат в [`plugin/adapters/`](plugin/adapters):
[opencode](plugin/adapters/opencode/README.md), [Codex](plugin/adapters/codex/README.md),
[pi](plugin/adapters/pi/README.md). Все они запускают тот же сервер, что и плагин.
## Что внутри
| | |
|---|---|
| **MCP-сервер `kompas`** | 74 инструмента: документы, эскизы, выдавливание/вращение/по сечениям/по траектории, оболочка, рёбра, уклон, скругления и фаски, массивы и зеркало, отверстия, булевы операции, прямое редактирование B-rep, переменные и параметризация, **исполнения** (несколько геометрий одной модели в одном файле), внешний вид (цвет, прозрачность, текстуры), сборки и сопряжения (в том числе по вспомогательным плоскостям и осям), 2D-чертежи (виды, размеры, обозначения, тех. требования), STEP/STL, осмотр (`describe_model`, `list_faces`, `list_edges`, `measure`) |
| **MCP-сервер `kompas`** | весь каталог инструментов; сервер едет в плагине, отдельно ставить нечего |
| **Навык `kompas-3d`** | методика построения: порядок работы, выбор подхода, проверенные приёмы и ловушки |
| **Навык `kompas-fdm-design`** | проектирование под FDM/FFF-печать: нависания, толщины стенок, зазоры и посадки, ориентация, бобышки и защёлки |
| **Команда `/kompas:doctor`** | диагностика установки |
| **Справка `help`** | инструмент `help(topic=…)` — статьи по механике и ловушкам, прямо в сессии |
| **Навык `kompas-fdm-design`** | проектирование под FDM-печать: нависания, толщины стенок, зазоры и посадки, ориентация, бобышки и защёлки |
| **Справка `help`** | `help(topic=…)` — статьи по механике и ловушкам, прямо в сессии |
| **Команда `/kompas:doctor`** | диагностика установки в Claude Code |
## Другие агентские харнессы
## Если что-то не работает
Тот же сервер подключается к Codex и opencode — сниппеты конфигурации лежат в
`plugin/adapters/{codex,opencode}/`.
| Клиент | Проверка |
|---|---|
| Claude Code | `/kompas:doctor` — версия сервера, КОМПАС, interop-сборки, соединение |
| Codex, pi, opencode | инструмент `kompas_status`; ответ «Не подключено» значит, что сначала нужен `kompas_connect` |
| Инструментов нет совсем | сервер не запустился: проверьте `dotnet --list-runtimes` |
Это репозиторий поставки: здесь лежат собранный сервер и материалы плагина, исходники сервера не
публикуются.
## Лицензия
+35
View File
@@ -0,0 +1,35 @@
<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="360" viewBox="0 0 1280 360" role="img" aria-label="kompas3d-mcp — MCP-сервер для КОМПАС-3D">
<defs>
<linearGradient id="bg" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#0d1b2e"/><stop offset="1" stop-color="#14304f"/></linearGradient>
<radialGradient id="glow" cx="0.2" cy="0.55" r="0.45"><stop offset="0" stop-color="#3fa9ff" stop-opacity="0.22"/><stop offset="1" stop-color="#3fa9ff" stop-opacity="0"/></radialGradient>
<marker id="ar" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,1 L10,5 L0,9 Z" fill="#ffb347"/></marker>
<clipPath id="r"><rect width="1280" height="360" rx="24"/></clipPath>
<style>
.top{fill:#2f6ea8;stroke:#9fd4ff;stroke-width:1.6;stroke-linejoin:round}
.left{fill:#1d4a78;stroke:#9fd4ff;stroke-width:1.6;stroke-linejoin:round}
.right{fill:#163a60;stroke:#9fd4ff;stroke-width:1.6;stroke-linejoin:round}
.hole{fill:#0b1626;stroke:#9fd4ff;stroke-width:1.6}
.hid{stroke:#5f8fbf;stroke-width:1.2;stroke-dasharray:6 5}
.ext{stroke:#ffb347;stroke-width:1;opacity:.7}
.dim{stroke:#ffb347;stroke-width:1.3;fill:none}
.dimt{fill:#ffb347;font:600 15px 'Consolas','JetBrains Mono',monospace}
.t1{fill:#ffffff;font:700 76px 'Segoe UI','Inter','Helvetica Neue',Arial,sans-serif;letter-spacing:-1px}
.t1 tspan.a{fill:#ffb347}
.t2{fill:#cfe6ff;font:500 28px 'Segoe UI','Inter','Helvetica Neue',Arial,sans-serif}
.chip rect{fill:#ffffff;fill-opacity:.07;stroke:#9fd4ff;stroke-opacity:.35}
.chip text{fill:#cfe6ff;font:500 17px 'Segoe UI','Inter',Arial,sans-serif}
</style>
</defs>
<g clip-path="url(#r)">
<rect width="1280" height="360" fill="url(#bg)"/>
<g stroke="#9fd4ff" stroke-opacity=".06" stroke-width="1"><line x1="0" y1="0" x2="0" y2="360"/><line x1="40" y1="0" x2="40" y2="360"/><line x1="80" y1="0" x2="80" y2="360"/><line x1="120" y1="0" x2="120" y2="360"/><line x1="160" y1="0" x2="160" y2="360"/><line x1="200" y1="0" x2="200" y2="360"/><line x1="240" y1="0" x2="240" y2="360"/><line x1="280" y1="0" x2="280" y2="360"/><line x1="320" y1="0" x2="320" y2="360"/><line x1="360" y1="0" x2="360" y2="360"/><line x1="400" y1="0" x2="400" y2="360"/><line x1="440" y1="0" x2="440" y2="360"/><line x1="480" y1="0" x2="480" y2="360"/><line x1="520" y1="0" x2="520" y2="360"/><line x1="560" y1="0" x2="560" y2="360"/><line x1="600" y1="0" x2="600" y2="360"/><line x1="640" y1="0" x2="640" y2="360"/><line x1="680" y1="0" x2="680" y2="360"/><line x1="720" y1="0" x2="720" y2="360"/><line x1="760" y1="0" x2="760" y2="360"/><line x1="800" y1="0" x2="800" y2="360"/><line x1="840" y1="0" x2="840" y2="360"/><line x1="880" y1="0" x2="880" y2="360"/><line x1="920" y1="0" x2="920" y2="360"/><line x1="960" y1="0" x2="960" y2="360"/><line x1="1000" y1="0" x2="1000" y2="360"/><line x1="1040" y1="0" x2="1040" y2="360"/><line x1="1080" y1="0" x2="1080" y2="360"/><line x1="1120" y1="0" x2="1120" y2="360"/><line x1="1160" y1="0" x2="1160" y2="360"/><line x1="1200" y1="0" x2="1200" y2="360"/><line x1="1240" y1="0" x2="1240" y2="360"/><line x1="1280" y1="0" x2="1280" y2="360"/><line x1="0" y1="0" x2="1280" y2="0"/><line x1="0" y1="40" x2="1280" y2="40"/><line x1="0" y1="80" x2="1280" y2="80"/><line x1="0" y1="120" x2="1280" y2="120"/><line x1="0" y1="160" x2="1280" y2="160"/><line x1="0" y1="200" x2="1280" y2="200"/><line x1="0" y1="240" x2="1280" y2="240"/><line x1="0" y1="280" x2="1280" y2="280"/><line x1="0" y1="320" x2="1280" y2="320"/><line x1="0" y1="360" x2="1280" y2="360"/></g>
<rect width="1280" height="360" fill="url(#glow)"/>
<g transform="translate(-20 4)"><line class="hid" x1="250.0" y1="188.0" x2="379.9" y2="263.0"/><line class="hid" x1="250.0" y1="188.0" x2="166.9" y2="236.0"/><line class="hid" x1="250.0" y1="188.0" x2="250.0" y2="78.0"/><polygon class="top" points="224.0,179.0 353.9,254.0 296.8,287.0 166.9,212.0"/><polygon class="left" points="166.9,236.0 296.8,311.0 296.8,287.0 166.9,212.0"/><polygon class="right" points="379.9,263.0 296.8,311.0 296.8,287.0 379.9,239.0"/><polygon class="top" points="250.0,78.0 379.9,153.0 353.9,168.0 224.0,93.0"/><polygon class="left" points="224.0,179.0 353.9,254.0 353.9,168.0 224.0,93.0"/><polygon class="right" points="379.9,239.0 353.9,254.0 353.9,168.0 379.9,153.0"/><path class="hole" d="M306.3,180.5 L306.2,178.5 L306.0,176.4 L305.5,174.3 L305.0,172.1 L304.2,169.9 L303.4,167.7 L302.4,165.5 L301.2,163.4 L300.0,161.4 L298.6,159.4 L297.1,157.6 L295.6,155.8 L294.0,154.3 L292.3,152.8 L290.7,151.6 L289.0,150.5 L287.3,149.6 L285.6,148.9 L283.9,148.5 L282.3,148.2 L280.8,148.1 L279.3,148.3 L278.0,148.7 L276.7,149.3 L275.6,150.1 L274.6,151.1 L273.7,152.3 L273.0,153.6 L272.4,155.1 L272.0,156.8 L271.7,158.6 L271.6,160.5 L271.7,162.5 L272.0,164.6 L272.4,166.7 L273.0,168.9 L273.7,171.1 L274.6,173.3 L275.6,175.5 L276.7,177.6 L278.0,179.6 L279.3,181.6 L280.8,183.4 L282.3,185.2 L283.9,186.7 L285.6,188.2 L287.3,189.4 L289.0,190.5 L290.7,191.4 L292.3,192.1 L294.0,192.5 L295.6,192.8 L297.1,192.9 L298.6,192.7 L300.0,192.3 L301.2,191.7 L302.4,190.9 L303.4,189.9 L304.2,188.7 L305.0,187.4 L305.5,185.9 L306.0,184.2 L306.2,182.4 Z"/><path class="hole" d="M237.0,222.5 L236.0,223.0 L235.0,223.5 L233.8,223.9 L232.6,224.2 L231.4,224.4 L230.1,224.6 L228.8,224.7 L227.5,224.8 L226.2,224.7 L224.9,224.6 L223.6,224.4 L222.3,224.2 L221.1,223.9 L220.0,223.5 L218.9,223.0 L218.0,222.5 L217.1,221.9 L216.3,221.3 L215.6,220.7 L215.0,220.0 L214.6,219.3 L214.3,218.5 L214.1,217.8 L214.0,217.0 L214.1,216.2 L214.3,215.5 L214.6,214.7 L215.0,214.0 L215.6,213.3 L216.3,212.7 L217.1,212.1 L218.0,211.5 L218.9,211.0 L220.0,210.5 L221.1,210.1 L222.3,209.8 L223.6,209.6 L224.9,209.4 L226.2,209.3 L227.5,209.2 L228.8,209.3 L230.1,209.4 L231.4,209.6 L232.6,209.8 L233.8,210.1 L235.0,210.5 L236.0,211.0 L237.0,211.5 L237.9,212.1 L238.7,212.7 L239.4,213.3 L239.9,214.0 L240.4,214.7 L240.7,215.5 L240.9,216.2 L241.0,217.0 L240.9,217.8 L240.7,218.5 L240.4,219.3 L239.9,220.0 L239.4,220.7 L238.7,221.3 L237.9,221.9 Z"/><path class="hole" d="M297.6,257.5 L296.7,258.0 L295.6,258.5 L294.5,258.9 L293.3,259.2 L292.0,259.4 L290.7,259.6 L289.4,259.7 L288.1,259.8 L286.8,259.7 L285.5,259.6 L284.2,259.4 L282.9,259.2 L281.8,258.9 L280.6,258.5 L279.6,258.0 L278.6,257.5 L277.7,256.9 L276.9,256.3 L276.2,255.7 L275.7,255.0 L275.2,254.3 L274.9,253.5 L274.7,252.8 L274.6,252.0 L274.7,251.2 L274.9,250.5 L275.2,249.7 L275.7,249.0 L276.2,248.3 L276.9,247.7 L277.7,247.1 L278.6,246.5 L279.6,246.0 L280.6,245.5 L281.8,245.1 L282.9,244.8 L284.2,244.6 L285.5,244.4 L286.8,244.3 L288.1,244.2 L289.4,244.3 L290.7,244.4 L292.0,244.6 L293.3,244.8 L294.5,245.1 L295.6,245.5 L296.7,246.0 L297.6,246.5 L298.5,247.1 L299.3,247.7 L300.0,248.3 L300.6,249.0 L301.0,249.7 L301.3,250.5 L301.5,251.2 L301.6,252.0 L301.5,252.8 L301.3,253.5 L301.0,254.3 L300.6,255.0 L300.0,255.7 L299.3,256.3 L298.5,256.9 Z"/><line class="ext" x1="163.4" y1="238.0" x2="139.2" y2="252.0"/><line class="ext" x1="293.3" y1="313.0" x2="269.1" y2="327.0"/><line class="dim" x1="144.3" y1="249.0" x2="274.2" y2="324.0" marker-start="url(#ar)" marker-end="url(#ar)"/><text class="dimt" transform="translate(209.3 286.5) rotate(30)" x="0" y="-6" text-anchor="middle">150</text><polyline class="dim" points="303.0,156.5 349.0,108.5 389.0,108.5"/><text class="dimt" x="353.0" y="102.5">Ø40</text></g>
<text x="524" y="80" fill="#9fd4ff" font-family="Consolas,JetBrains Mono,monospace" font-size="16" letter-spacing="3">MODEL CONTEXT PROTOCOL · COM API5/API7</text>
<text class="t1" x="520" y="150">kompas3d<tspan class="a">-mcp</tspan></text>
<text class="t2" x="524" y="196">КОМПАС-3D в руках языковой модели</text>
<g class="chip"><rect x="524" y="232" width="86" height="36" rx="18"/><text x="567.0" y="256" text-anchor="middle">эскизы</text></g><g class="chip"><rect x="622" y="232" width="114" height="36" rx="18"/><text x="679.0" y="256" text-anchor="middle">3D-детали</text></g><g class="chip"><rect x="748" y="232" width="86" height="36" rx="18"/><text x="791.0" y="256" text-anchor="middle">сборки</text></g><g class="chip"><rect x="846" y="232" width="95" height="36" rx="18"/><text x="893.5" y="256" text-anchor="middle">чертежи</text></g><g class="chip"><rect x="953" y="232" width="180" height="36" rx="18"/><text x="1043.0" y="256" text-anchor="middle">STEP · STL · DXF</text></g>
<text x="1256" y="346" text-anchor="end" fill="#9fd4ff" fill-opacity=".4" font-family="Consolas,monospace" font-size="12">ГОСТ 2.317 · изометрия</text>
</g>
<rect x=".75" y=".75" width="1278.5" height="358.5" rx="23.5" fill="none" stroke="#9fd4ff" stroke-opacity=".25" stroke-width="1.5"/>
</svg>

After

Width:  |  Height:  |  Size: 8.5 KiB

+73
View File
@@ -0,0 +1,73 @@
<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="540" viewBox="0 0 1280 540" role="img" aria-label="Пример: запрос на кронштейн, семь вызовов инструментов агентом и ответ сервера с габаритом и ведомой переменной H">
<defs>
<linearGradient id="bg" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#0d1b2e"/><stop offset="1" stop-color="#14304f"/></linearGradient>
<marker id="ar" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,1 L10,5 L0,9 Z" fill="#ffb347"/></marker>
<marker id="fl" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="9" markerHeight="9" orient="auto"><path d="M0,1 L10,5 L0,9 Z" fill="#9fd4ff"/></marker>
<style>
.top{fill:#2f6ea8;stroke:#9fd4ff;stroke-width:1.4;stroke-linejoin:round}
.left{fill:#1d4a78;stroke:#9fd4ff;stroke-width:1.4;stroke-linejoin:round}
.right{fill:#163a60;stroke:#9fd4ff;stroke-width:1.4;stroke-linejoin:round}
.hole{fill:#0b1626;stroke:#9fd4ff;stroke-width:1.4}
.ext{stroke:#ffb347;stroke-width:1;opacity:.7}
.dim{stroke:#ffb347;stroke-width:1.4}
.dimt{fill:#ffb347;font:700 20px Consolas,'JetBrains Mono',monospace}
.cap{fill:#9fd4ff;font:600 16px Consolas,'JetBrains Mono',monospace;letter-spacing:2.5px}
.who{fill:#fff;font:700 28px 'Segoe UI','Inter',Arial,sans-serif}
.req{fill:#cfe6ff;font:500 21px 'Segoe UI','Inter',Arial,sans-serif}
.reqb{fill:#fff;font:700 21px 'Segoe UI','Inter',Arial,sans-serif}
.call{fill:#cfe6ff;font:500 19px Consolas,'JetBrains Mono',monospace}
.num{fill:#ffb347;font:700 15px Consolas,monospace}
.ok{fill:#fff;font:700 21px 'Segoe UI','Inter',Arial,sans-serif}
.res{fill:#cfe6ff;font:500 19px 'Segoe UI','Inter',Arial,sans-serif}
.hint{fill:#ffb347;font:600 17px Consolas,'JetBrains Mono',monospace}
</style></defs>
<rect width="1280" height="540" rx="24" fill="url(#bg)"/>
<rect x=".75" y=".75" width="1278.5" height="538.5" rx="23.25" fill="none" stroke="#9fd4ff" stroke-opacity=".25" stroke-width="1.5"/>
<text class="cap" x="36" y="52" text-anchor="start" >01 · ЗАПРОС</text>
<text class="who" x="36" y="92" text-anchor="start" >Вы</text>
<rect x="36" y="112" width="340" height="396" rx="16" fill="#fff" fill-opacity=".05" stroke="#9fd4ff" stroke-opacity=".35" stroke-width="1.5"/>
<text class="cap" x="436" y="52" text-anchor="start" >02 · ВЫЗОВЫ</text>
<text class="who" x="436" y="92" text-anchor="start" >Агент</text>
<rect x="436" y="112" width="420" height="396" rx="16" fill="#fff" fill-opacity=".05" stroke="#9fd4ff" stroke-opacity=".35" stroke-width="1.5"/>
<text class="cap" x="916" y="52" text-anchor="start" >03 · ОТВЕТ</text>
<text class="who" x="916" y="92" text-anchor="start" >Сервер</text>
<rect x="916" y="112" width="328" height="396" rx="16" fill="#fff" fill-opacity=".05" stroke="#9fd4ff" stroke-opacity=".35" stroke-width="1.5"/>
<line x1="380" y1="310" x2="432" y2="310" stroke="#9fd4ff" stroke-width="2" marker-end="url(#fl)"/>
<line x1="860" y1="310" x2="912" y2="310" stroke="#9fd4ff" stroke-width="2" marker-end="url(#fl)"/>
<text class="reqb" x="64" y="158" text-anchor="start" >Кронштейн:</text>
<text class="req" x="64" y="192" text-anchor="start" >полка 150 × 96 × 24,</text>
<text class="req" x="64" y="226" text-anchor="start" >стойка высотой 110</text>
<text class="req" x="64" y="260" text-anchor="start" >с отверстием Ø40,</text>
<text class="req" x="64" y="294" text-anchor="start" >в полке два</text>
<text class="req" x="64" y="328" text-anchor="start" >крепёжных Ø11.</text>
<text class="reqb" x="64" y="396" text-anchor="start" >Высоту стойки —</text>
<text class="reqb" x="64" y="430" text-anchor="start" >переменной.</text>
<circle cx="474" cy="154" r="13" fill="none" stroke="#ffb347" stroke-width="1.5"/>
<text class="num" x="474" y="159" text-anchor="middle" >1</text>
<text class="call" x="500" y="160" text-anchor="start" >document_create(part)</text>
<circle cx="474" cy="198" r="13" fill="none" stroke="#ffb347" stroke-width="1.5"/>
<text class="num" x="474" y="203" text-anchor="middle" >2</text>
<text class="call" x="500" y="204" text-anchor="start" >set_variable(H = 110)</text>
<circle cx="474" cy="242" r="13" fill="none" stroke="#ffb347" stroke-width="1.5"/>
<text class="num" x="474" y="247" text-anchor="middle" >3</text>
<text class="call" x="500" y="248" text-anchor="start" >primitive(block 150×96×24)</text>
<circle cx="474" cy="286" r="13" fill="none" stroke="#ffb347" stroke-width="1.5"/>
<text class="num" x="474" y="291" text-anchor="middle" >4</text>
<text class="call" x="500" y="292" text-anchor="start" >primitive(height = "H",</text>
<text class="call" x="522" y="336" text-anchor="start" >result = union)</text>
<circle cx="474" cy="374" r="13" fill="none" stroke="#ffb347" stroke-width="1.5"/>
<text class="num" x="474" y="379" text-anchor="middle" >5</text>
<text class="call" x="500" y="380" text-anchor="start" >hole(Ø40, сквозное)</text>
<circle cx="474" cy="418" r="13" fill="none" stroke="#ffb347" stroke-width="1.5"/>
<text class="num" x="474" y="423" text-anchor="middle" >6</text>
<text class="call" x="500" y="424" text-anchor="start" >hole(Ø11, points = [2])</text>
<circle cx="474" cy="462" r="13" fill="none" stroke="#ffb347" stroke-width="1.5"/>
<text class="num" x="474" y="467" text-anchor="middle" >7</text>
<text class="call" x="500" y="468" text-anchor="start" >describe_model(box, mass)</text>
<polygon class="top" points="1033.7,215.0 1135.1,273.5 1090.5,299.2 989.2,240.7"/><polygon class="left" points="989.2,259.4 1090.5,317.9 1090.5,299.2 989.2,240.7"/><polygon class="right" points="1155.3,280.5 1090.5,317.9 1090.5,299.2 1155.3,261.8"/><polygon class="top" points="1054.0,136.2 1155.3,194.7 1135.1,206.4 1033.7,147.9"/><polygon class="left" points="1033.7,215.0 1135.1,273.5 1135.1,206.4 1033.7,147.9"/><polygon class="right" points="1155.3,261.8 1135.1,273.5 1135.1,206.4 1155.3,194.7"/><path class="hole" d="M1097.9,216.2 L1097.8,214.0 L1097.4,211.8 L1096.9,209.6 L1096.1,207.3 L1095.1,205.0 L1093.9,202.8 L1092.6,200.7 L1091.2,198.7 L1089.6,196.9 L1087.9,195.3 L1086.2,193.9 L1084.4,192.8 L1082.6,191.9 L1080.9,191.3 L1079.2,191.0 L1077.6,190.9 L1076.2,191.2 L1074.8,191.8 L1073.7,192.7 L1072.7,193.8 L1071.9,195.2 L1071.3,196.8 L1071.0,198.6 L1070.9,200.6 L1071.0,202.7 L1071.3,204.9 L1071.9,207.1 L1072.7,209.4 L1073.7,211.7 L1074.8,213.9 L1076.2,216.0 L1077.6,218.0 L1079.2,219.8 L1080.9,221.4 L1082.6,222.8 L1084.4,223.9 L1086.2,224.8 L1087.9,225.4 L1089.6,225.7 L1091.2,225.8 L1092.6,225.5 L1093.9,224.9 L1095.1,224.0 L1096.1,222.9 L1096.9,221.5 L1097.4,219.9 L1097.8,218.1 Z"/><path class="hole" d="M1043.9,248.9 L1042.8,249.4 L1041.7,249.9 L1040.5,250.2 L1039.2,250.5 L1037.8,250.6 L1036.4,250.7 L1035.1,250.6 L1033.7,250.5 L1032.4,250.2 L1031.2,249.9 L1030.0,249.4 L1029.0,248.9 L1028.1,248.3 L1027.3,247.7 L1026.7,246.9 L1026.3,246.2 L1026.0,245.4 L1025.9,244.6 L1026.0,243.8 L1026.3,243.0 L1026.7,242.3 L1027.3,241.6 L1028.1,240.9 L1029.0,240.3 L1030.0,239.8 L1031.2,239.4 L1032.4,239.0 L1033.7,238.8 L1035.1,238.6 L1036.4,238.6 L1037.8,238.6 L1039.2,238.8 L1040.5,239.0 L1041.7,239.4 L1042.8,239.8 L1043.9,240.3 L1044.8,240.9 L1045.5,241.6 L1046.1,242.3 L1046.6,243.0 L1046.9,243.8 L1046.9,244.6 L1046.9,245.4 L1046.6,246.2 L1046.1,246.9 L1045.5,247.7 L1044.8,248.3 Z"/><path class="hole" d="M1091.2,276.2 L1090.1,276.7 L1089.0,277.2 L1087.7,277.5 L1086.4,277.8 L1085.1,277.9 L1083.7,278.0 L1082.3,277.9 L1081.0,277.8 L1079.7,277.5 L1078.5,277.2 L1077.3,276.7 L1076.3,276.2 L1075.4,275.6 L1074.6,275.0 L1074.0,274.2 L1073.6,273.5 L1073.3,272.7 L1073.2,271.9 L1073.3,271.1 L1073.6,270.3 L1074.0,269.6 L1074.6,268.9 L1075.4,268.2 L1076.3,267.6 L1077.3,267.1 L1078.5,266.7 L1079.7,266.3 L1081.0,266.1 L1082.3,265.9 L1083.7,265.9 L1085.1,265.9 L1086.4,266.1 L1087.7,266.3 L1089.0,266.7 L1090.1,267.1 L1091.2,267.6 L1092.1,268.2 L1092.8,268.9 L1093.4,269.6 L1093.9,270.3 L1094.1,271.1 L1094.2,271.9 L1094.1,272.7 L1093.9,273.5 L1093.4,274.2 L1092.8,275.0 L1092.1,275.6 Z"/><line class="ext" x1="1158.0" y1="282.1" x2="1175.2" y2="292.1"/><line class="ext" x1="1158.0" y1="196.3" x2="1175.2" y2="206.3"/><line class="dim" x1="1170.2" y1="289.1" x2="1170.2" y2="203.3" marker-start="url(#ar)" marker-end="url(#ar)"/><text class="dimt" x="1180.2" y="252.2">H</text>
<text class="ok" x="944" y="350" text-anchor="start" >✓ Построение чистое</text>
<text class="res" x="944" y="384" text-anchor="start" >тел: 1</text>
<text class="res" x="944" y="414" text-anchor="start" >габарит 150 × 96 × 110 мм</text>
<text class="res" x="944" y="452" text-anchor="start" >H ведёт высоту стойки:</text>
<text class="hint" x="944" y="484" text-anchor="start" >set_variable(H = 140)</text>
</svg>

After

Width:  |  Height:  |  Size: 8.7 KiB

+43
View File
@@ -0,0 +1,43 @@
<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="312" viewBox="0 0 1280 312" role="img" aria-label="Схема: агент вызывает инструменты kompas3d-mcp, сервер управляет КОМПАС-3D через COM и возвращает факты со сверкой">
<defs>
<linearGradient id="bg" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#0d1b2e"/><stop offset="1" stop-color="#14304f"/></linearGradient>
<marker id="aL" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="9" markerHeight="9" orient="auto"><path d="M0,1 L10,5 L0,9 Z" fill="#9fd4ff"/></marker>
<marker id="aA" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="9" markerHeight="9" orient="auto"><path d="M0,1 L10,5 L0,9 Z" fill="#ffb347"/></marker>
<style>
.h{fill:#fff;font:700 32px 'Segoe UI','Inter',Arial,sans-serif}
.s{fill:#cfe6ff;font:500 20px 'Segoe UI','Inter',Arial,sans-serif}
.n{fill:#9fd4ff;fill-opacity:.8;font:19px 'Segoe UI','Inter',Arial,sans-serif}
.l{font:600 18px 'Consolas','JetBrains Mono',monospace}
</style></defs>
<rect width="1280" height="312" rx="24" fill="url(#bg)"/>
<rect x=".75" y=".75" width="1278.5" height="310.5" rx="23.25" fill="none" stroke="#9fd4ff" stroke-opacity=".25" stroke-width="1.5"/>
<rect x="40" y="68" width="320" height="172" rx="16" fill="#ffffff" fill-opacity="0.05" stroke="#9fd4ff" stroke-opacity="0.45" stroke-width="1.5"/>
<text class="h" x="200" y="116" text-anchor="middle">LLM-агент</text>
<text class="s" x="200" y="148" text-anchor="middle" style="font-size:18px">Claude Code · Codex · pi · opencode</text>
<text class="n" x="200" y="184" text-anchor="middle">навыки kompas-3d и</text>
<text class="n" x="200" y="208" text-anchor="middle">kompas-fdm-design</text>
<rect x="480" y="68" width="320" height="172" rx="16" fill="#ffffff" fill-opacity="0.1" stroke="#ffb347" stroke-opacity="0.9" stroke-width="2"/>
<text class="h" x="640" y="116" text-anchor="middle">kompas3d-mcp</text>
<text class="s" x="640" y="148" text-anchor="middle">инструменты · справка help</text>
<text class="n" x="640" y="184" text-anchor="middle">STA-поток, хендлы,</text>
<text class="n" x="640" y="208" text-anchor="middle">сверка с запросом</text>
<rect x="920" y="68" width="320" height="172" rx="16" fill="#ffffff" fill-opacity="0.05" stroke="#9fd4ff" stroke-opacity="0.45" stroke-width="1.5"/>
<text class="h" x="1080" y="116" text-anchor="middle">КОМПАС-3D</text>
<text class="s" x="1080" y="148" text-anchor="middle">COM API7 / API5</text>
<text class="n" x="1080" y="184" text-anchor="middle">окно пользователя или</text>
<text class="n" x="1080" y="208" text-anchor="middle">свой скрытый экземпляр</text>
<line x1="366" y1="122" x2="474" y2="122" stroke="#9fd4ff" stroke-width="2" marker-end="url(#aL)"/>
<text class="l" x="420.0" y="0" text-anchor="middle" fill="#9fd4ff"></text>
<line x1="806" y1="122" x2="914" y2="122" stroke="#9fd4ff" stroke-width="2" marker-end="url(#aL)"/>
<text class="l" x="860.0" y="0" text-anchor="middle" fill="#9fd4ff"></text>
<line x1="474" y1="178" x2="366" y2="178" stroke="#ffb347" stroke-width="2" marker-end="url(#aA)"/>
<text class="l" x="420.0" y="0" text-anchor="middle" fill="#ffb347"></text>
<line x1="914" y1="178" x2="806" y2="178" stroke="#ffb347" stroke-width="2" marker-end="url(#aA)"/>
<text class="l" x="860.0" y="0" text-anchor="middle" fill="#ffb347"></text>
<text class="l" x="420" y="34" text-anchor="middle" fill="#9fd4ff">вызов</text><text class="l" x="420" y="55" text-anchor="middle" fill="#9fd4ff">инструмента</text>
<text class="l" x="860" y="34" text-anchor="middle" fill="#9fd4ff">COM-</text><text class="l" x="860" y="55" text-anchor="middle" fill="#9fd4ff">вызовы</text>
<text class="l" x="420" y="268" text-anchor="middle" fill="#ffb347">факты +</text><text class="l" x="420" y="289" text-anchor="middle" fill="#ffb347">сверка</text>
<text class="l" x="860" y="268" text-anchor="middle" fill="#ffb347">геометрия,</text><text class="l" x="860" y="289" text-anchor="middle" fill="#ffb347">дерево, ошибки</text>
<text class="l" x="420" y="150" text-anchor="middle" fill="#9fd4ff" fill-opacity=".6" font-size="15">MCP</text>
<text class="l" x="860" y="150" text-anchor="middle" fill="#9fd4ff" fill-opacity=".6" font-size="15">COM</text>
</svg>

After

Width:  |  Height:  |  Size: 4.3 KiB

+1
View File
@@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" viewBox="0 0 48 48" role="img" aria-label="Сборки"><title>Сборки</title><rect width="48" height="48" rx="0" fill="#14304f"/><rect x=".75" y=".75" width="46.5" height="46.5" rx="0" fill="none" stroke="#9fd4ff" stroke-opacity=".35" stroke-width="1.5"/><polygon points="24.0,21.5 38.3,29.8 30.5,34.2 16.2,26.0" fill="#2f6ea8" stroke="#9fd4ff" stroke-width="1.4" stroke-linejoin="round"/><polygon points="16.2,30.5 30.5,38.8 30.5,34.2 16.2,26.0" fill="#1d4a78" stroke="#9fd4ff" stroke-width="1.4" stroke-linejoin="round"/><polygon points="38.3,34.2 30.5,38.8 30.5,34.2 38.3,29.8" fill="#163a60" stroke="#9fd4ff" stroke-width="1.4" stroke-linejoin="round"/><polygon points="25.3,13.2 33.1,17.8 27.9,20.8 20.1,16.2" fill="#2f6ea8" stroke="#9fd4ff" stroke-width="1.4" stroke-linejoin="round"/><polygon points="20.1,26.8 27.9,31.2 27.9,20.8 20.1,16.2" fill="#1d4a78" stroke="#9fd4ff" stroke-width="1.4" stroke-linejoin="round"/><polygon points="33.1,28.2 27.9,31.2 27.9,20.8 33.1,17.8" fill="#163a60" stroke="#9fd4ff" stroke-width="1.4" stroke-linejoin="round"/><line x1="26.6" y1="11.5" x2="26.6" y2="38.0" stroke="#ffb347" stroke-width="1.4" stroke-dasharray="5 2 1 2"/></svg>

After

Width:  |  Height:  |  Size: 1.2 KiB

+1
View File
@@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" viewBox="0 0 48 48" role="img" aria-label="Чертежи"><title>Чертежи</title><rect width="48" height="48" rx="0" fill="#14304f"/><rect x=".75" y=".75" width="46.5" height="46.5" rx="0" fill="none" stroke="#9fd4ff" stroke-opacity=".35" stroke-width="1.5"/><rect x="9" y="8" width="30" height="32" fill="none" stroke="#9fd4ff" stroke-width="1.4"/><rect x="14" y="13" width="14" height="10" fill="#1d4a78" stroke="#9fd4ff" stroke-width="1.2"/><circle cx="21" cy="18" r="2.4" fill="none" stroke="#9fd4ff" stroke-width="1.1"/><path d="M14 26 H28 M14 26 l3 -1.5 v3 Z M28 26 l-3 -1.5 v3 Z" stroke="#ffb347" fill="#ffb347" stroke-width="1"/><path d="M24 32 H39 M24 32 V40 M31 32 V40 M24 36 H39" stroke="#9fd4ff" stroke-width="1"/></svg>

After

Width:  |  Height:  |  Size: 803 B

+1
View File
@@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" viewBox="0 0 48 48" role="img" aria-label="Экспорт"><title>Экспорт</title><rect width="48" height="48" rx="0" fill="#14304f"/><rect x=".75" y=".75" width="46.5" height="46.5" rx="0" fill="none" stroke="#9fd4ff" stroke-opacity=".35" stroke-width="1.5"/><polygon points="20.0,19.6 29.0,24.8 20.0,30.0 11.0,24.8" fill="#2f6ea8" stroke="#9fd4ff" stroke-width="1.4" stroke-linejoin="round"/><polygon points="11.0,35.2 20.0,40.4 20.0,30.0 11.0,24.8" fill="#1d4a78" stroke="#9fd4ff" stroke-width="1.4" stroke-linejoin="round"/><polygon points="29.0,35.2 20.0,40.4 20.0,30.0 29.0,24.8" fill="#163a60" stroke="#9fd4ff" stroke-width="1.4" stroke-linejoin="round"/><path d="M30 17 Q34 9 43 9" fill="none" stroke="#ffb347" stroke-width="2"/><path d="M39 5.5 L43.5 9 L39 12.5" fill="none" stroke="#ffb347" stroke-width="2" stroke-linejoin="round" stroke-linecap="round"/></svg>

After

Width:  |  Height:  |  Size: 942 B

+1
View File
@@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" viewBox="0 0 48 48" role="img" aria-label="Импорт"><title>Импорт</title><rect width="48" height="48" rx="0" fill="#14304f"/><rect x=".75" y=".75" width="46.5" height="46.5" rx="0" fill="none" stroke="#9fd4ff" stroke-opacity=".35" stroke-width="1.5"/><polygon points="30.0,19.6 39.0,24.8 30.0,30.0 21.0,24.8" fill="#2f6ea8" stroke="#9fd4ff" stroke-width="1.4" stroke-linejoin="round"/><polygon points="21.0,35.2 30.0,40.4 30.0,30.0 21.0,24.8" fill="#1d4a78" stroke="#9fd4ff" stroke-width="1.4" stroke-linejoin="round"/><polygon points="39.0,35.2 30.0,40.4 30.0,30.0 39.0,24.8" fill="#163a60" stroke="#9fd4ff" stroke-width="1.4" stroke-linejoin="round"/><path d="M5 9 Q14 9 18 17" fill="none" stroke="#ffb347" stroke-width="2"/><path d="M14.5 17.5 L19.5 19 L20 13.8" fill="none" stroke="#ffb347" stroke-width="2" stroke-linejoin="round" stroke-linecap="round"/></svg>

After

Width:  |  Height:  |  Size: 941 B

+1
View File
@@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" viewBox="0 0 48 48" role="img" aria-label="Осмотр"><title>Осмотр</title><rect width="48" height="48" rx="0" fill="#14304f"/><rect x=".75" y=".75" width="46.5" height="46.5" rx="0" fill="none" stroke="#9fd4ff" stroke-opacity=".35" stroke-width="1.5"/><polygon points="20.0,16.2 29.4,21.6 20.0,27.0 10.6,21.6" fill="#2f6ea8" stroke="#9fd4ff" stroke-width="1.4" stroke-linejoin="round"/><polygon points="10.6,32.4 20.0,37.8 20.0,27.0 10.6,21.6" fill="#1d4a78" stroke="#9fd4ff" stroke-width="1.4" stroke-linejoin="round"/><polygon points="29.4,32.4 20.0,37.8 20.0,27.0 29.4,21.6" fill="#163a60" stroke="#9fd4ff" stroke-width="1.4" stroke-linejoin="round"/><circle cx="31" cy="29" r="8" fill="#0b1626" fill-opacity=".55" stroke="#ffb347" stroke-width="2"/><line x1="36.8" y1="34.8" x2="42" y2="40" stroke="#ffb347" stroke-width="3" stroke-linecap="round"/></svg>

After

Width:  |  Height:  |  Size: 933 B

+1
View File
@@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" viewBox="0 0 48 48" role="img" aria-label="Параметрика"><title>Параметрика</title><rect width="48" height="48" rx="0" fill="#14304f"/><rect x=".75" y=".75" width="46.5" height="46.5" rx="0" fill="none" stroke="#9fd4ff" stroke-opacity=".35" stroke-width="1.5"/><line x1="10" y1="12" x2="10" y2="36" stroke="#9fd4ff" stroke-width="1.4"/><line x1="38" y1="12" x2="38" y2="36" stroke="#9fd4ff" stroke-width="1.4"/><path d="M12 30 H36 M12 30 l4 -2.5 v5 Z M36 30 l-4 -2.5 v5 Z" stroke="#ffb347" fill="#ffb347" stroke-width="1.4" stroke-linejoin="round"/><text x="24" y="23" text-anchor="middle" fill="#ffb347" font-family="Consolas,monospace" font-size="11" font-weight="700">H*2</text></svg>

After

Width:  |  Height:  |  Size: 772 B

+1
View File
@@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" viewBox="0 0 48 48" role="img" aria-label="Детали"><title>Детали</title><rect width="48" height="48" rx="0" fill="#14304f"/><rect x=".75" y=".75" width="46.5" height="46.5" rx="0" fill="none" stroke="#9fd4ff" stroke-opacity=".35" stroke-width="1.5"/><polygon points="24.0,23.8 37.9,31.8 24.0,39.8 10.1,31.8" fill="#2f6ea8" stroke="#9fd4ff" stroke-width="1.4" stroke-linejoin="round"/><polygon points="10.1,36.0 24.0,44.0 24.0,39.8 10.1,31.8" fill="#1d4a78" stroke="#9fd4ff" stroke-width="1.4" stroke-linejoin="round"/><polygon points="37.9,36.0 24.0,44.0 24.0,39.8 37.9,31.8" fill="#163a60" stroke="#9fd4ff" stroke-width="1.4" stroke-linejoin="round"/><polygon points="24.0,11.0 37.9,19.0 33.4,21.6 19.6,13.6" fill="#2f6ea8" stroke="#9fd4ff" stroke-width="1.4" stroke-linejoin="round"/><polygon points="19.6,26.4 33.4,34.4 33.4,21.6 19.6,13.6" fill="#1d4a78" stroke="#9fd4ff" stroke-width="1.4" stroke-linejoin="round"/><polygon points="37.9,31.8 33.4,34.4 33.4,21.6 37.9,19.0" fill="#163a60" stroke="#9fd4ff" stroke-width="1.4" stroke-linejoin="round"/><ellipse cx="26.5" cy="23.4" rx="3.2" ry="4.2" transform="rotate(-30 26.5 23.4)" fill="#0b1626" stroke="#9fd4ff" stroke-width="1.2"/></svg>

After

Width:  |  Height:  |  Size: 1.2 KiB

+24
View File
@@ -0,0 +1,24 @@
{
"name": "kompas",
"version": "0.7.7",
"description": "КОМПАС-3D для агента pi: MCP-сервер (детали, эскизы, формообразующие операции, сборки, чертежи, STEP) плюс навыки kompas-3d и kompas-fdm-design. Установка: pi install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git",
"license": "MIT",
"keywords": [
"pi-package",
"cad",
"kompas",
"3d",
"step",
"mcp",
"fdm"
],
"repository": "https://git.shahovalov.ru/mikhail/kompas-plugin",
"pi": {
"extensions": [
"./plugin/pi/kompas.ts"
],
"skills": [
"./plugin/skills"
]
}
}
+6 -4
View File
@@ -1,19 +1,21 @@
{
"name": "kompas",
"displayName": "КОМПАС-3D",
"version": "0.4.0",
"version": "0.7.7",
"description": "Управление КОМПАС-3D из Claude Code: детали, сборки, чертежи, STEP — через MCP-сервер",
"author": {
"name": "Shahovalov Mikhail",
"email": "miha.shahovalov@gmail.com"
},
"homepage": "https://git.shahovalov.ru/mikhail/kompas3d-mcp",
"repository": "https://git.shahovalov.ru/mikhail/kompas3d-mcp",
"homepage": "https://git.shahovalov.ru/mikhail/kompas-plugin",
"repository": "https://git.shahovalov.ru/mikhail/kompas-plugin",
"license": "MIT",
"keywords": [
"cad",
"kompas",
"3d",
"step",
"mcp"
"mcp",
"fdm"
]
}
+77 -34
View File
@@ -1,43 +1,93 @@
# Плагин `kompas` — КОМПАС-3D в Claude Code
<img src="assets/icon.svg" alt="" width="64" height="64" align="right">
Даёт Claude Code инструменты управления КОМПАС-3D (детали, сборки, чертежи, STEP) и методику работы
с ними: навыки `kompas:kompas-3d` и `kompas:kompas-fdm-design`.
# Плагин `kompas`
## Предпосылки
КОМПАС-3D в Claude Code, Codex и pi: инструменты управления (детали, сборки, чертежи, STEP) и
методика работы с ними. Витрина и список изменений —
[прилавок `kompas-plugin`](https://git.shahovalov.ru/mikhail/kompas-plugin).
- Windows x64;
- установленный КОМПАС-3D (проверено на v25 Home, v24 Home тоже поддерживается) — сервер является COM-клиентом, а не автономным
CAD-движком, и работает только на той же машине. Запускать заранее не нужно: сервер присоединится
к открытому окну, а если его нет — запустит экземпляр сам;
- КОМПАС установлен **вместе с компонентом 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, рантайм берётся с машины. Проверка: `dotnet --list-runtimes`
показывает `Microsoft.NETCore.App 8.x` или новее;
- чекаут репозитория и рабочие файлы — вне синхронизируемых папок OneDrive.
```text
plugin/
├─ bin/ сервер kompas-mcp.exe, кладёт релиз
├─ skills/ kompas-3d, kompas-fdm-design
├─ commands/doctor.md /kompas:doctor в Claude Code
├─ scripts/ launch-kompas-mcp.ps1, общий лаунчер всех клиентов
├─ pi/ расширение для pi-пакета
├─ adapters/ ручное подключение: codex, opencode, pi
└─ assets/ значок плагина
```
## Требования
| | |
|---|---|
| **Windows x64** | сервер — COM-клиент КОМПАС, а не автономный CAD-движок, и работает только на той же машине |
| **КОМПАС-3D с компонентом SDK** | проверено на v25 Home, v24 Home тоже поддерживается; запускать заранее не нужно — сервер присоединится к открытому окну или запустит экземпляр сам |
| **[.NET Runtime](https://dotnet.microsoft.com/download/dotnet) 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
```text
/plugin marketplace add https://git.shahovalov.ru/mikhail/kompas-plugin.git
/plugin install kompas@kompas-plugin
/kompas:doctor
```
Сервер (`bin/kompas-mcp.exe`) едет вместе с плагином — отдельно скачивать и устанавливать нечего.
`/kompas:doctor` проверяет версию, наличие .NET и КОМПАС, interop-сборки и соединение.
`/kompas:doctor` проверяет версию, наличие .NET и КОМПАС, interop-сборки и соединение. Обновление:
## Обновление
```
```text
/plugin marketplace update kompas-plugin
/plugin update kompas@kompas-plugin
```
Если инструменты остались прежними — `/reload-plugins`.
### Codex
```powershell
codex plugin marketplace add https://git.shahovalov.ru/mikhail/kompas-plugin.git
```
Затем установите `kompas` из источника `kompas-plugin` в каталоге плагинов Codex и начните новый чат.
Обновление — `codex plugin marketplace upgrade kompas-plugin`, затем обновите плагин в интерфейсе.
Проверка соединения — инструмент `kompas_status`; если он отвечает «Не подключено», сначала вызовите
`kompas_connect`.
### pi
Прилавок — pi-пакет целиком: расширение регистрирует MCP-сервер, навыки идут вместе.
```text
pi install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git
pi list
```
Обновление — `pi update --extensions`: пакет без закреплённого ref синхронизируется с веткой. Новые
записи `CHANGELOG.md` pi показывает при следующем запуске (при первой загрузке пакета — нет). Версию
можно закрепить тегом:
```text
pi install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git@v0.7.5
```
Закреплённый тег не меняется при `pi update --extensions`: для перехода повторите `pi install` с новым
тегом или без ref. Проверка соединения — как в Codex, инструмент `kompas_status`. Манифест пакета —
`package.json` в корне прилавка, расширение — `pi/kompas.ts`.
### Ручное подключение
Лаунчер `scripts/launch-kompas-mcp.ps1` подключается и к другим харнессам — см. `adapters/codex/`,
`adapters/opencode/` и `adapters/pi/`. Это сниппеты и инструкция, а не отдельные дистрибутивы: навыки
и лаунчер не размножаются.
## Промпты и ресурсы
Сервер отдаёт готовые маршруты работы промптами — `part`, `import-edit-export`, `drawing`,
@@ -47,21 +97,14 @@
## Разработка сервера
Переменная окружения `KOMPAS_MCP_EXE` подменяет поставленный бинарь своим:
Переменная окружения `KOMPAS_MCP_EXE` подменяет поставленный бинарь своим, и лаунчер не смотрит в
`bin/` плагина:
```powershell
$env:KOMPAS_MCP_EXE = "<путь>\kompas-mcp.exe"
```
Тогда лаунчер `scripts/launch-kompas-mcp.ps1` не смотрит в `bin/` плагина.
## Что остаётся после удаления
## Другие харнессы (Codex, opencode)
Тот же лаунчер подключается и к другим агентским харнессам — см. `adapters/codex/` и
`adapters/opencode/`. Это сниппеты конфигурации и инструкция, а не отдельные дистрибутивы:
контент (навыки, лаунчер) не размножается, новый харнесс стоит README + сниппета.
## Прочее
Каталог `%LOCALAPPDATA%\kompas-mcp` (распакованные interop-сборки, при разработке — временные
файлы) не очищается при обновлении и удалении плагина — удаляется вручную.
Каталог `%LOCALAPPDATA%\kompas-mcp` (распакованные interop-сборки, при разработке — временные файлы)
не очищается при обновлении и удалении плагина — удаляется вручную.
+4 -4
View File
@@ -1,10 +1,10 @@
# Подключение к Codex
Codex не знает ни маркетплейсов, ни `${CLAUDE_PLUGIN_ROOT}`, поэтому подключение делается по пути
к каталогу плагина.
Плагин можно установить из каталога `kompas-plugin`: см. README публичного репозитория.
Инструкция ниже — альтернативное ручное подключение без плагина.
1. Склонировать `https://git.shahovalov.ru/mikhail/kompas-plugin.git` — сервер лежит внутри,
в `plugin/bin/`, собирать ничего не нужно (требуется .NET Runtime 8+ x64).
в `plugin/bin/`, собирать ничего не нужно (требуется .NET Runtime 10+ x64).
2. Вставить `config.snippet.toml` в `~/.codex/config.toml`, заменив `<PLUGIN>` на абсолютный путь
к каталогу `plugin/` клона. Лаунчер `scripts/launch-kompas-mcp.ps1` — тот же, что у плагина
Claude Code.
@@ -17,4 +17,4 @@ Codex не знает ни маркетплейсов, ни `${CLAUDE_PLUGIN_ROO
Свой собранный сервер подставляется переменной окружения `KOMPAS_MCP_EXE` — она перекрывает
`plugin/bin/kompas-mcp.exe`.
Это сниппет и инструкция, а не дистрибутив: полноценный плагин Codex — отдельная веха.
Это сниппет для ручного подключения, а не отдельный дистрибутив.
+1 -1
View File
@@ -1,7 +1,7 @@
# Подключение к opencode
1. Склонировать `https://git.shahovalov.ru/mikhail/kompas-plugin.git` — сервер лежит внутри,
в `plugin/bin/` (требуется .NET Runtime 8+ x64).
в `plugin/bin/` (требуется .NET Runtime 10+ x64).
2. Слить `opencode.json` со своим конфигом opencode, заменив `<PLUGIN>` на абсолютный путь к
каталогу `plugin/` клона. Используется тот же лаунчер `scripts/launch-kompas-mcp.ps1`.
3. Навыки: скопировать `plugin/skills/{kompas-3d,kompas-fdm-design}` в каталог навыков агента
+24
View File
@@ -0,0 +1,24 @@
# Подключение к pi
Основной путь — pi-пакет целиком (см. [README плагина](../../README.md)): `pi install git:…` ставит и MCP-сервер
через расширение, и оба навыка, и поддерживает обновления.
Ручная альтернатива — тот же лаунчер, подключённый напрямую к конфигурации pi:
1. Склонировать `https://git.shahovalov.ru/mikhail/kompas-plugin.git` — сервер лежит внутри,
в `plugin/bin/` (требуется .NET Runtime 10+ x64).
2. Зарегистрировать MCP-сервер, заменив `<PLUGIN>` на абсолютный путь к каталогу `plugin/`
клона:
```powershell
pi mcp add kompas -- powershell -NoProfile -NonInteractive -ExecutionPolicy Bypass -File "<PLUGIN>\scripts\launch-kompas-mcp.ps1"
```
…или слить `mcp.snippet.json` со своим `~/.pi/agent/mcp.json`.
3. Навыки: скопировать `plugin/skills/{kompas-3d,kompas-fdm-design}` в
`~/.pi/agent/skills/` (или подключить их другим удобным способом).
Свой собранный сервер подставляется переменной окружения `KOMPAS_MCP_EXE` — она перекрывает
`plugin/bin/kompas-mcp.exe`.
Это сниппет и инструкция, а не дистрибутив.
+10
View File
@@ -0,0 +1,10 @@
{
"mcpServers": {
"kompas": {
"command": "powershell",
"args": ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass",
"-File", "<PLUGIN>/scripts/launch-kompas-mcp.ps1"],
"description": "Контроль КОМПАС-3D: детали, эскизы, формообразующие операции, сборки, чертежи, STEP/STL, осмотр модели"
}
}
}
+1
View File
@@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" width="96" height="96" viewBox="0 0 48 48" role="img" aria-label="КОМПАС-3D"><title>КОМПАС-3D</title><defs><linearGradient id="bg" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#0d1b2e"/><stop offset="1" stop-color="#14304f"/></linearGradient></defs><rect width="48" height="48" rx="10" fill="url(#bg)"/><rect x=".5" y=".5" width="47" height="47" rx="9.5" fill="none" stroke="#9fd4ff" stroke-opacity=".35"/><g transform="translate(0 -3.5)" stroke="#9fd4ff" stroke-width="1.4" stroke-linejoin="round"><polygon points="24.0,23.8 37.9,31.8 24.0,39.8 10.1,31.8" fill="#2f6ea8"/><polygon points="10.1,36.0 24.0,44.0 24.0,39.8 10.1,31.8" fill="#1d4a78"/><polygon points="37.9,36.0 24.0,44.0 24.0,39.8 37.9,31.8" fill="#163a60"/><polygon points="24.0,11.0 37.9,19.0 33.4,21.6 19.6,13.6" fill="#2f6ea8"/><polygon points="19.6,26.4 33.4,34.4 33.4,21.6 19.6,13.6" fill="#1d4a78"/><polygon points="37.9,31.8 33.4,34.4 33.4,21.6 37.9,19.0" fill="#163a60"/><ellipse cx="26.5" cy="23.4" rx="3.2" ry="4.2" transform="rotate(-30 26.5 23.4)" fill="#0b1626" stroke-width="1.2"/></g></svg>

After

Width:  |  Height:  |  Size: 1.1 KiB

Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
File diff suppressed because it is too large. Load diff
Binary file not shown.
Binary file not shown.
Binary file not shown.
+4 -3
View File
@@ -1,14 +1,15 @@
{
"runtimeOptions": {
"tfm": "net8.0",
"tfm": "net10.0",
"rollForward": "LatestMajor",
"framework": {
"name": "Microsoft.NETCore.App",
"version": "8.0.0"
"version": "10.0.0"
},
"configProperties": {
"System.Reflection.Metadata.MetadataUpdater.IsSupported": false,
"System.Runtime.Serialization.EnableUnsafeBinaryFormatterSerialization": false
"System.Runtime.Serialization.EnableUnsafeBinaryFormatterSerialization": false,
"CSWINRT_USE_WINDOWS_UI_XAML_PROJECTIONS": false
}
}
}
+2 -2
View File
@@ -28,9 +28,9 @@ description: "Диагностика установки плагина КОМП
`/plugin update kompas@kompas-plugin`, затем `/reload-plugins`.
4. **.NET Runtime.** Сервер поставляется framework-dependent, поэтому рантайм нужен на машине:
`dotnet --list-runtimes` должен показать строку `Microsoft.NETCore.App 8.<любая>` или новее
`dotnet --list-runtimes` должен показать строку `Microsoft.NETCore.App 10.<любая>` или новее
(x64). Ни одной подходящей строки или самой команды `dotnet` нет — это и есть причина сбоя
пункта 3: попроси пользователя поставить .NET Runtime 8 или новее с
пункта 3: попроси пользователя поставить .NET Runtime 10 или новее с
https://dotnet.microsoft.com/download/dotnet (нужен именно x64; Desktop Runtime не обязателен).
5. **КОМПАС-3D установлен и, возможно, уже запущен.** Сервер подключается к КОМПАС лениво — не при
+10
View File
@@ -0,0 +1,10 @@
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
"mcpServers": {
"kompas": {
"type": "stdio",
"command": "powershell",
"args": ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-File", "${PLUGIN_ROOT}/scripts/launch-kompas-mcp.ps1"]
}
}
}
+36
View File
@@ -0,0 +1,36 @@
// pi-расширение пакета kompas: регистрирует MCP-сервер КОМПАС-3D.
//
// Сервер и лаунчер едут внутри одного пакета (plugin/bin + plugin/scripts),
// поэтому путь резолвится от этого файла. Регистрация не сохраняется, поэтому
// она повторяется при каждой загрузке расширения.
//
// Свой сервер подставляется переменной окружения KOMPAS_MCP_EXE — ей управляет
// лаунчер launch-kompas-mcp.ps1, а не это расширение.
import path from "node:path";
import { fileURLToPath } from "node:url";
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
const launcher = path.resolve(
path.dirname(fileURLToPath(import.meta.url)),
"..",
"scripts",
"launch-kompas-mcp.ps1",
);
export default function (pi: ExtensionAPI) {
pi.registerMcpServer("kompas", {
command: "powershell",
args: [
"-NoProfile",
"-NonInteractive",
"-ExecutionPolicy",
"Bypass",
"-File",
launcher,
],
exposure: "deferred",
description:
"Контроль КОМПАС-3D: детали, эскизы, формообразующие операции, сборки, 2D-чертежи, STEP/STL, осмотр модели — через MCP-сервер kompas-mcp.exe",
});
}
+28
View File
@@ -0,0 +1,28 @@
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "kompas",
"version": "0.7.7",
"description": "Управление КОМПАС-3D через MCP: детали, сборки, чертежи и STEP.",
"author": {
"name": "Shahovalov Mikhail"
},
"license": "MIT",
"extensions": {
"com.openai": {
"requires_local_executor": true,
"interface": {
"displayName": "КОМПАС-3D",
"shortDescription": "Детали, сборки и чертежи в КОМПАС-3D",
"longDescription": "Создание и редактирование деталей, сборок и чертежей КОМПАС-3D через локальный MCP-сервер, импорт и экспорт STEP и STL, осмотр модели и методика построения.",
"developerName": "Shahovalov Mikhail",
"category": "Productivity",
"websiteURL": "https://git.shahovalov.ru/mikhail/kompas-plugin",
"logo": "./assets/icon.svg",
"logoDark": "./assets/icon.svg",
"composerIcon": "./assets/icon.svg",
"brandColor": "#2F6EA8",
"brandColorDark": "#9FD4FF"
}
}
}
}
+1 -1
View File
@@ -40,7 +40,7 @@ catch {
# Самая частая причина здесь — отсутствующий .NET Runtime: сервер поставляется
# framework-dependent, и без рантайма apphost падает именно тут.
[Console]::Error.WriteLine("kompas-mcp launcher: не удалось запустить сервер: $($_.Exception.Message)")
[Console]::Error.WriteLine("kompas-mcp launcher: если .NET Runtime не установлен — https://dotnet.microsoft.com/download/dotnet (нужен .NET 8 или новее, x64)")
[Console]::Error.WriteLine("kompas-mcp launcher: если .NET Runtime не установлен — https://dotnet.microsoft.com/download/dotnet (нужен .NET 10 или новее, x64)")
exit 1
}
+13 -4
View File
@@ -46,6 +46,14 @@ MCP-сервер даёт **общие** операции КОМПАС (эски
## Два правила прежде всего
**Показывай построение человеку в чате.** При создании или изменении детали/сборки вызови
`model_preview` сразу после появления первого тела или загрузки существующей модели. Повторяй
после существенных этапов и в конце: виджет показывает снимок на момент вызова и сам не
обновляется. Не вызывай его после каждой операции и пока открыт эскиз на редактировании. Если
клиент не поддерживает MCP Apps (`shown: false`), больше не повторяй вызов и предложи
`model_snapshot` по запросу. Превью предназначено человеку и не заменяет численную проверку модели;
подробности — `help(topic="live-preview")`.
**1. «Зрение» — структурное, не по картинке.** «Увидеть» деталь = **`describe_model`** — паспорт
одним запросом и ЕДИНСТВЕННЫЙ инструмент осмотра: разделы `box | mass | bodies | topology | tree |
variables | errors | components` (`sections` сужает и ответ, и объём чтения модели). Углубляться —
@@ -153,6 +161,8 @@ variables | errors | components` (`sections` сужает и ответ, и об
| Переменное сечение: хвост, гребень, переход круга в квадрат | `loft` по сечениям на смещённых плоскостях (`mode=boss` приклеивает к телу) |
| Труба, поручень, кант по кривой | `sweep(profileSketchId, pathSketchId)` — профиль и траектория на разных плоскостях |
| Тонкая стенка, ободок по контуру | эскиз + `extrude(thinThickness, thinSide)` |
| Наклонная полка, скос, элемент под углом | `sketch_create(plane, planeAngle, planeAxis)` или `planePoints` (три вершины) + `extrude`; сторону берёт нормаль из ответа — `help(topic="auxiliary-planes")` |
| Резьба на валу или в отверстии (M10, M8×1) | `thread` на цилиндрической грани — условное изображение, тело не режет; в отверстии сначала `hole` под сверло (M10 → Ø8.5), потом `thread` — `help(topic="threads")` |
Их **сочетают в одной детали**: корпусные объёмы — примитивами, сложные контуры — эскизами.
@@ -321,8 +331,8 @@ variables | errors | components` (`sections` сужает и ответ, и об
файл детали не меняется — но он перекрывает ВСЕ акценты детали (надпись станет цвета
компонента). Нужны акценты — оставь компоненту наследуемый цвет. Грань или тело ВНУТРИ
компонента из сборки не красятся: акценты, общие для всех экземпляров, задают в файле детали.
- **Передача дальше**: STEP несёт цвета и прозрачность — ответ `export_model` их перечисляет; STL
цветов не несёт.
- **Передача дальше**: STEP несёт цвета и прозрачность, но не текстуры и вырезы; STL не несёт
оформления вовсе. Ответ `export_model` перечисляет попавшие цвета и называет, что потеряно.
- **Отделка по материалу**: металл — `finish="metal"` (`silver`, `gold`), пластик — `satin` или
`matte`, `glossy` — умолчание КОМПАС.
- **Текстура — там, где она что-то говорит**: накатка на рукоятке (`texture="diamond knurl"`,
@@ -336,8 +346,7 @@ variables | errors | components` (`sections` сужает и ответ, и об
на снимке, не трогая массу и топологию. Нужны настоящие отверстия под крепёж или DFM — это
`hole`/`pattern`, вырез их не заменяет. Рисунок «не тем боком» — `textureAngle`, сдвиг —
`textureOffset` (оба вместе с повтором имён `texture` и `cutout` — повернётся только то, что
названо в вызове; поворот 0…180°). Смена рисунка плитку и раскладку сохраняет. В STEP уходят
только цвета — текстуры и вырезы остаются в `.m3d`.
названо в вызове; поворот 0…180°). Смена рисунка плитку и раскладку сохраняет.
- **Проверка — глазами**: `model_snapshot(view="iso")` после раскраски; что окрашено на самом
деле — `describe_model(sections=appearance)`. Прозрачность снимок не рисует — её видно только
в разделе `appearance`.
@@ -38,9 +38,11 @@
| «сдвинуть грань на N мм» | `move_face` | это он и есть |
| «диаметр отверстия (бобышки) должен стать D» | **`resize_face`** | задаётся ДИАМЕТР, ось не двигается; `move_face` сдвинул бы стенку на (D−d)/2, и это пришлось бы считать самому |
| «грань должна встать НА объект: на плоскость, на грань соседнего тела» | **`replace_face`** | расстояние считает КОМПАС; `move_face` требует вычислить его заранее |
| «убрать отверстие / скругление / фаску» с импорта (дефичеринг) | **`remove_face`** | соседние грани затягивают место сами; заливка отверстия телом и вычитание — лишние операции. `saveBody=false` оставляет дыру (тело-оболочка, объём 0) — нужен только если надо именно её |
| «увеличить / уменьшить деталь целиком», компенсация усадки (1.004) | **`scale_body`** | `scale` равномерно или `scaleX/Y/Z`; центр — начало координат либо `x,y,z`; объём сверяется ×kx·ky·kz. Размеры эскизов и переменные остаются прежними — масштабируется тело |
| вставка N мм в призматическую ножку | `split_solid_by_plane` → `move_body` → `move_face` (мост) → `boolean` | цепочка проверена end-to-end: проставка 39.45 → 41.45 мм |
`resize_face` и `replace_face` требуют КОМПАС v25; на версиях старше они отвечают отказом с
`resize_face`, `replace_face` и `remove_face` требуют КОМПАС v25; на версиях старше они отвечают отказом с
номером установленной версии, и тогда остаётся `move_face` с арифметикой.
**Проверяйте прямое редактирование РАЗНОСТЬЮ ОБЪЁМОВ против аналитической формулы** — объём и так
+4 -4
View File
@@ -1,6 +1,6 @@
{
"version": "0.4.0",
"tag": "v0.4.0",
"sourceSha": "f1ecc6ff5a923d524a7aa8dc7b97c538d9cf1bb3",
"built": "2026-10-15T03:15:33Z"
"version": "0.7.7",
"tag": "v0.7.7",
"sourceSha": "66b8a4d74db323335a048aa7298f49d3337ae277",
"built": "2026-11-17T05:27:17Z"
}