Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
e6864b9d6b | ||
|
|
ef953f6e4b | ||
|
|
d514b45b88 | ||
|
|
a89c68491f | ||
|
|
3340b9ecf7 | ||
|
|
0a1d3f710d | ||
|
|
c0d650aef8 | ||
|
|
67d09d05c9 |
No files matched your search
@@ -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" }
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
@@ -0,0 +1,18 @@
|
|||||||
|
# Changelog
|
||||||
|
|
||||||
|
## [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 для подключения сервера без установки пакета.
|
||||||
@@ -1,4 +1,4 @@
|
|||||||
# КОМПАС-3D в Claude Code
|
# КОМПАС-3D в Claude Code, Codex и pi
|
||||||
|
|
||||||
Каталог плагинов с одним плагином — **`kompas`**. Он даёт Claude Code управление
|
Каталог плагинов с одним плагином — **`kompas`**. Он даёт Claude Code управление
|
||||||
[КОМПАС-3D](https://ascon.ru/products/7/) (АСКОН) через MCP-сервер: детали, эскизы,
|
[КОМПАС-3D](https://ascon.ru/products/7/) (АСКОН) через MCP-сервер: детали, эскизы,
|
||||||
@@ -24,7 +24,7 @@ STEP/STL, осмотр и измерение модели — плюс два н
|
|||||||
Запускать КОМПАС заранее не нужно: сервер присоединится к открытому окну, а если его нет —
|
Запускать КОМПАС заранее не нужно: сервер присоединится к открытому окну, а если его нет —
|
||||||
запустит экземпляр сам.
|
запустит экземпляр сам.
|
||||||
|
|
||||||
## Установка
|
## Установка в Claude Code
|
||||||
|
|
||||||
```
|
```
|
||||||
/plugin marketplace add https://git.shahovalov.ru/mikhail/kompas-plugin.git
|
/plugin marketplace add https://git.shahovalov.ru/mikhail/kompas-plugin.git
|
||||||
@@ -35,7 +35,7 @@ STEP/STL, осмотр и измерение модели — плюс два н
|
|||||||
`/kompas:doctor` — диагностика: версия сервера, установлен ли КОМПАС, на месте ли interop-сборки,
|
`/kompas:doctor` — диагностика: версия сервера, установлен ли КОМПАС, на месте ли interop-сборки,
|
||||||
проходит ли соединение. С неё стоит начинать разбор любой неполадки.
|
проходит ли соединение. С неё стоит начинать разбор любой неполадки.
|
||||||
|
|
||||||
## Обновление
|
## Обновление в Claude Code
|
||||||
|
|
||||||
```
|
```
|
||||||
/plugin marketplace update kompas-plugin
|
/plugin marketplace update kompas-plugin
|
||||||
@@ -48,16 +48,50 @@ STEP/STL, осмотр и измерение модели — плюс два н
|
|||||||
|
|
||||||
| | |
|
| | |
|
||||||
|---|---|
|
|---|---|
|
||||||
| **MCP-сервер `kompas`** | 74 инструмента: документы, эскизы, выдавливание/вращение/по сечениям/по траектории, оболочка, рёбра, уклон, скругления и фаски, массивы и зеркало, отверстия, булевы операции, прямое редактирование B-rep, переменные и параметризация, **исполнения** (несколько геометрий одной модели в одном файле), внешний вид (цвет, прозрачность, текстуры), сборки и сопряжения (в том числе по вспомогательным плоскостям и осям), 2D-чертежи (виды, размеры, обозначения, тех. требования), STEP/STL, осмотр (`describe_model`, `list_faces`, `list_edges`, `measure`) |
|
| **MCP-сервер `kompas`** | 78 инструментов: документы, эскизы, выдавливание/вращение/по сечениям/по траектории, оболочка, рёбра, уклон, скругления и фаски, массивы и зеркало, отверстия, булевы операции, прямое редактирование B-rep, переменные и параметризация, **исполнения** (несколько геометрий одной модели в одном файле), внешний вид (цвет, прозрачность, текстуры), сборки и сопряжения (в том числе по вспомогательным плоскостям и осям), 2D-чертежи (виды, размеры, обозначения, тех. требования), STEP/STL, осмотр (`describe_model`, `list_faces`, `list_edges`, `measure`) |
|
||||||
| **Навык `kompas-3d`** | методика построения: порядок работы, выбор подхода, проверенные приёмы и ловушки |
|
| **Навык `kompas-3d`** | методика построения: порядок работы, выбор подхода, проверенные приёмы и ловушки |
|
||||||
| **Навык `kompas-fdm-design`** | проектирование под FDM/FFF-печать: нависания, толщины стенок, зазоры и посадки, ориентация, бобышки и защёлки |
|
| **Навык `kompas-fdm-design`** | проектирование под FDM/FFF-печать: нависания, толщины стенок, зазоры и посадки, ориентация, бобышки и защёлки |
|
||||||
| **Команда `/kompas:doctor`** | диагностика установки |
|
| **Команда `/kompas:doctor`** | диагностика установки |
|
||||||
| **Справка `help`** | инструмент `help(topic=…)` — статьи по механике и ловушкам, прямо в сессии |
|
| **Справка `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 — сниппеты конфигурации лежат в
|
Тот же сервер можно подключить вручную к Codex, opencode и pi — сниппеты конфигурации лежат в
|
||||||
`plugin/adapters/{codex,opencode}/`.
|
`plugin/adapters/{codex,opencode,pi}/`.
|
||||||
|
|
||||||
## Лицензия
|
## Лицензия
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,24 @@
|
|||||||
|
{
|
||||||
|
"name": "kompas",
|
||||||
|
"version": "0.7.6",
|
||||||
|
"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"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,7 +1,7 @@
|
|||||||
{
|
{
|
||||||
"name": "kompas",
|
"name": "kompas",
|
||||||
"displayName": "КОМПАС-3D",
|
"displayName": "КОМПАС-3D",
|
||||||
"version": "0.5.0",
|
"version": "0.7.6",
|
||||||
"description": "Управление КОМПАС-3D из Claude Code: детали, сборки, чертежи, STEP — через MCP-сервер",
|
"description": "Управление КОМПАС-3D из Claude Code: детали, сборки, чертежи, STEP — через MCP-сервер",
|
||||||
"author": {
|
"author": {
|
||||||
"name": "Shahovalov Mikhail",
|
"name": "Shahovalov Mikhail",
|
||||||
|
|||||||
+31
-7
@@ -1,7 +1,7 @@
|
|||||||
# Плагин `kompas` — КОМПАС-3D в Claude Code
|
# Плагин `kompas` — КОМПАС-3D в Claude Code, Codex и pi
|
||||||
|
|
||||||
Даёт Claude Code инструменты управления КОМПАС-3D (детали, сборки, чертежи, STEP) и методику работы
|
Даёт агенту инструменты управления КОМПАС-3D (детали, сборки, чертежи, STEP) и методику работы
|
||||||
с ними: навыки `kompas:kompas-3d` и `kompas:kompas-fdm-design`.
|
с ними: навыки `kompas-3d` и `kompas-fdm-design`.
|
||||||
|
|
||||||
## Предпосылки
|
## Предпосылки
|
||||||
|
|
||||||
@@ -38,6 +38,29 @@
|
|||||||
|
|
||||||
Если инструменты остались прежними — `/reload-plugins`.
|
Если инструменты остались прежними — `/reload-plugins`.
|
||||||
|
|
||||||
|
## Установка в pi
|
||||||
|
|
||||||
|
Тот же прилавок — pi-пакет целиком: расширение регистрирует MCP-сервер, навыки идут вместе.
|
||||||
|
|
||||||
|
```
|
||||||
|
pi install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git
|
||||||
|
pi list
|
||||||
|
```
|
||||||
|
|
||||||
|
Обновление — `pi update --extensions`: пакет без закреплённого ref синхронизируется с веткой.
|
||||||
|
После обновления pi показывает новые записи из `CHANGELOG.md` при следующем новом запуске;
|
||||||
|
при первой загрузке пакета changelog не показывается.
|
||||||
|
Версию можно закрепить тегом:
|
||||||
|
|
||||||
|
```
|
||||||
|
pi install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git@v0.7.5
|
||||||
|
```
|
||||||
|
|
||||||
|
Закреплённый тег не меняется при `pi update --extensions`; для перехода на другую версию
|
||||||
|
повторите `pi install` с новым тегом или без ref.
|
||||||
|
Проверка соединения — инструмент `kompas_status` (команда `/kompas:doctor` принадлежит Claude Code).
|
||||||
|
Ручная альтернатива без пакета — `adapters/pi/`.
|
||||||
|
|
||||||
## Промпты и ресурсы
|
## Промпты и ресурсы
|
||||||
|
|
||||||
Сервер отдаёт готовые маршруты работы промптами — `part`, `import-edit-export`, `drawing`,
|
Сервер отдаёт готовые маршруты работы промптами — `part`, `import-edit-export`, `drawing`,
|
||||||
@@ -55,11 +78,12 @@ $env:KOMPAS_MCP_EXE = "<путь>\kompas-mcp.exe"
|
|||||||
|
|
||||||
Тогда лаунчер `scripts/launch-kompas-mcp.ps1` не смотрит в `bin/` плагина.
|
Тогда лаунчер `scripts/launch-kompas-mcp.ps1` не смотрит в `bin/` плагина.
|
||||||
|
|
||||||
## Другие харнессы (Codex, opencode)
|
## Другие харнессы (Codex, opencode, pi)
|
||||||
|
|
||||||
Тот же лаунчер подключается и к другим агентским харнессам — см. `adapters/codex/` и
|
Тот же лаунчер подключается и к другим агентским харнессам — см. `adapters/codex/`,
|
||||||
`adapters/opencode/`. Это сниппеты конфигурации и инструкция, а не отдельные дистрибутивы:
|
`adapters/opencode/` и `adapters/pi/`. Это сниппеты конфигурации и инструкция, а не отдельные
|
||||||
контент (навыки, лаунчер) не размножается, новый харнесс стоит README + сниппета.
|
дистрибутивы: контент (навыки, лаунчер) не размножается, новый харнесс стоит README + сниппета.
|
||||||
|
Для pi основной путь — pi-пакет (`package.json` в корне прилавка, расширение `plugin/pi/kompas.ts`).
|
||||||
|
|
||||||
## Прочее
|
## Прочее
|
||||||
|
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
# Подключение к Codex
|
# Подключение к Codex
|
||||||
|
|
||||||
Codex не знает ни маркетплейсов, ни `${CLAUDE_PLUGIN_ROOT}`, поэтому подключение делается по пути
|
Плагин можно установить из каталога `kompas-plugin`: см. README публичного репозитория.
|
||||||
к каталогу плагина.
|
Инструкция ниже — альтернативное ручное подключение без плагина.
|
||||||
|
|
||||||
1. Склонировать `https://git.shahovalov.ru/mikhail/kompas-plugin.git` — сервер лежит внутри,
|
1. Склонировать `https://git.shahovalov.ru/mikhail/kompas-plugin.git` — сервер лежит внутри,
|
||||||
в `plugin/bin/`, собирать ничего не нужно (требуется .NET Runtime 10+ x64).
|
в `plugin/bin/`, собирать ничего не нужно (требуется .NET Runtime 10+ x64).
|
||||||
@@ -17,4 +17,4 @@ Codex не знает ни маркетплейсов, ни `${CLAUDE_PLUGIN_ROO
|
|||||||
Свой собранный сервер подставляется переменной окружения `KOMPAS_MCP_EXE` — она перекрывает
|
Свой собранный сервер подставляется переменной окружения `KOMPAS_MCP_EXE` — она перекрывает
|
||||||
`plugin/bin/kompas-mcp.exe`.
|
`plugin/bin/kompas-mcp.exe`.
|
||||||
|
|
||||||
Это сниппет и инструкция, а не дистрибутив: полноценный плагин Codex — отдельная веха.
|
Это сниппет для ручного подключения, а не отдельный дистрибутив.
|
||||||
@@ -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`.
|
||||||
|
|
||||||
|
Это сниппет и инструкция, а не дистрибутив.
|
||||||
@@ -0,0 +1,10 @@
|
|||||||
|
{
|
||||||
|
"mcpServers": {
|
||||||
|
"kompas": {
|
||||||
|
"command": "powershell",
|
||||||
|
"args": ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass",
|
||||||
|
"-File", "<PLUGIN>/scripts/launch-kompas-mcp.ps1"],
|
||||||
|
"description": "Контроль КОМПАС-3D: детали, эскизы, формообразующие операции, сборки, чертежи, STEP/STL, осмотр модели"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
Binary file not shown.
Binary file not shown.
@@ -7,9 +7,9 @@
|
|||||||
"targets": {
|
"targets": {
|
||||||
".NETCoreApp,Version=v10.0": {},
|
".NETCoreApp,Version=v10.0": {},
|
||||||
".NETCoreApp,Version=v10.0/win-x64": {
|
".NETCoreApp,Version=v10.0/win-x64": {
|
||||||
"kompas-mcp/0.5.0": {
|
"kompas-mcp/0.7.6": {
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"Kompas.Mcp.Core": "0.5.0",
|
"Kompas.Mcp.Core": "0.7.6",
|
||||||
"Microsoft.Extensions.Hosting": "10.0.14",
|
"Microsoft.Extensions.Hosting": "10.0.14",
|
||||||
"ModelContextProtocol": "2.3.0"
|
"ModelContextProtocol": "2.3.0"
|
||||||
},
|
},
|
||||||
@@ -433,21 +433,21 @@
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"Kompas.Mcp.Core/0.5.0": {
|
"Kompas.Mcp.Core/0.7.6": {
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"Microsoft.Extensions.Logging.Abstractions": "10.0.14"
|
"Microsoft.Extensions.Logging.Abstractions": "10.0.14"
|
||||||
},
|
},
|
||||||
"runtime": {
|
"runtime": {
|
||||||
"Kompas.Mcp.Core.dll": {
|
"Kompas.Mcp.Core.dll": {
|
||||||
"assemblyVersion": "0.5.0.0",
|
"assemblyVersion": "0.7.6.0",
|
||||||
"fileVersion": "0.5.0.0"
|
"fileVersion": "0.7.6.0"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"libraries": {
|
"libraries": {
|
||||||
"kompas-mcp/0.5.0": {
|
"kompas-mcp/0.7.6": {
|
||||||
"type": "project",
|
"type": "project",
|
||||||
"serviceable": false,
|
"serviceable": false,
|
||||||
"sha512": ""
|
"sha512": ""
|
||||||
@@ -676,7 +676,7 @@
|
|||||||
"path": "system.diagnostics.eventlog/10.0.14",
|
"path": "system.diagnostics.eventlog/10.0.14",
|
||||||
"hashPath": "system.diagnostics.eventlog.10.0.14.nupkg.sha512"
|
"hashPath": "system.diagnostics.eventlog.10.0.14.nupkg.sha512"
|
||||||
},
|
},
|
||||||
"Kompas.Mcp.Core/0.5.0": {
|
"Kompas.Mcp.Core/0.7.6": {
|
||||||
"type": "project",
|
"type": "project",
|
||||||
"serviceable": false,
|
"serviceable": false,
|
||||||
"sha512": ""
|
"sha512": ""
|
||||||
|
|||||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
@@ -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"]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -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",
|
||||||
|
});
|
||||||
|
}
|
||||||
@@ -0,0 +1,21 @@
|
|||||||
|
{
|
||||||
|
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
|
||||||
|
"name": "kompas",
|
||||||
|
"version": "0.7.6",
|
||||||
|
"description": "Управление КОМПАС-3D через MCP: детали, сборки, чертежи и STEP.",
|
||||||
|
"author": {
|
||||||
|
"name": "Shahovalov Mikhail"
|
||||||
|
},
|
||||||
|
"extensions": {
|
||||||
|
"com.openai": {
|
||||||
|
"requires_local_executor": true,
|
||||||
|
"interface": {
|
||||||
|
"displayName": "КОМПАС-3D",
|
||||||
|
"shortDescription": "Управление КОМПАС-3D",
|
||||||
|
"longDescription": "Создание и редактирование моделей и чертежей КОМПАС-3D через локальный MCP-сервер.",
|
||||||
|
"developerName": "Shahovalov Mikhail",
|
||||||
|
"category": "Productivity"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -46,6 +46,14 @@ MCP-сервер даёт **общие** операции КОМПАС (эски
|
|||||||
|
|
||||||
## Два правила прежде всего
|
## Два правила прежде всего
|
||||||
|
|
||||||
|
**Показывай построение человеку в чате.** При создании или изменении детали/сборки вызови
|
||||||
|
`model_preview` сразу после появления первого тела или загрузки существующей модели. Повторяй
|
||||||
|
после существенных этапов и в конце: виджет показывает снимок на момент вызова и сам не
|
||||||
|
обновляется. Не вызывай его после каждой операции и пока открыт эскиз на редактировании. Если
|
||||||
|
клиент не поддерживает MCP Apps (`shown: false`), больше не повторяй вызов и предложи
|
||||||
|
`model_snapshot` по запросу. Превью предназначено человеку и не заменяет численную проверку модели;
|
||||||
|
подробности — `help(topic="live-preview")`.
|
||||||
|
|
||||||
**1. «Зрение» — структурное, не по картинке.** «Увидеть» деталь = **`describe_model`** — паспорт
|
**1. «Зрение» — структурное, не по картинке.** «Увидеть» деталь = **`describe_model`** — паспорт
|
||||||
одним запросом и ЕДИНСТВЕННЫЙ инструмент осмотра: разделы `box | mass | bodies | topology | tree |
|
одним запросом и ЕДИНСТВЕННЫЙ инструмент осмотра: разделы `box | mass | bodies | topology | tree |
|
||||||
variables | errors | components` (`sections` сужает и ответ, и объём чтения модели). Углубляться —
|
variables | errors | components` (`sections` сужает и ответ, и объём чтения модели). Углубляться —
|
||||||
@@ -153,6 +161,8 @@ variables | errors | components` (`sections` сужает и ответ, и об
|
|||||||
| Переменное сечение: хвост, гребень, переход круга в квадрат | `loft` по сечениям на смещённых плоскостях (`mode=boss` приклеивает к телу) |
|
| Переменное сечение: хвост, гребень, переход круга в квадрат | `loft` по сечениям на смещённых плоскостях (`mode=boss` приклеивает к телу) |
|
||||||
| Труба, поручень, кант по кривой | `sweep(profileSketchId, pathSketchId)` — профиль и траектория на разных плоскостях |
|
| Труба, поручень, кант по кривой | `sweep(profileSketchId, pathSketchId)` — профиль и траектория на разных плоскостях |
|
||||||
| Тонкая стенка, ободок по контуру | эскиз + `extrude(thinThickness, thinSide)` |
|
| Тонкая стенка, ободок по контуру | эскиз + `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")` |
|
||||||
|
|
||||||
Их **сочетают в одной детали**: корпусные объёмы — примитивами, сложные контуры — эскизами.
|
Их **сочетают в одной детали**: корпусные объёмы — примитивами, сложные контуры — эскизами.
|
||||||
|
|
||||||
|
|||||||
@@ -38,9 +38,11 @@
|
|||||||
| «сдвинуть грань на N мм» | `move_face` | это он и есть |
|
| «сдвинуть грань на N мм» | `move_face` | это он и есть |
|
||||||
| «диаметр отверстия (бобышки) должен стать D» | **`resize_face`** | задаётся ДИАМЕТР, ось не двигается; `move_face` сдвинул бы стенку на (D−d)/2, и это пришлось бы считать самому |
|
| «диаметр отверстия (бобышки) должен стать D» | **`resize_face`** | задаётся ДИАМЕТР, ось не двигается; `move_face` сдвинул бы стенку на (D−d)/2, и это пришлось бы считать самому |
|
||||||
| «грань должна встать НА объект: на плоскость, на грань соседнего тела» | **`replace_face`** | расстояние считает КОМПАС; `move_face` требует вычислить его заранее |
|
| «грань должна встать НА объект: на плоскость, на грань соседнего тела» | **`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 мм |
|
| вставка 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` с арифметикой.
|
номером установленной версии, и тогда остаётся `move_face` с арифметикой.
|
||||||
|
|
||||||
**Проверяйте прямое редактирование РАЗНОСТЬЮ ОБЪЁМОВ против аналитической формулы** — объём и так
|
**Проверяйте прямое редактирование РАЗНОСТЬЮ ОБЪЁМОВ против аналитической формулы** — объём и так
|
||||||
|
|||||||
+4
-4
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"version": "0.5.0",
|
"version": "0.7.6",
|
||||||
"tag": "v0.5.0",
|
"tag": "v0.7.6",
|
||||||
"sourceSha": "29b0f1188a1ddafad5b49076f73d75239bd9bc76",
|
"sourceSha": "c9f42fb464d371c577a4c883a84e1dc4b1d49561",
|
||||||
"built": "2026-10-26T20:45:56Z"
|
"built": "2026-11-03T20:22:23Z"
|
||||||
}
|
}
|
||||||
Reference in new issue
Block a user