Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
ef953f6e4b | ||
|
|
d514b45b88 | ||
|
|
a89c68491f | ||
|
|
3340b9ecf7 | ||
|
|
0a1d3f710d | ||
|
|
c0d650aef8 | ||
|
|
67d09d05c9 | ||
|
|
a1942b228d |
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" }
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
@@ -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-сервер: детали, эскизы,
|
||||||
@@ -16,15 +16,15 @@ STEP/STL, осмотр и измерение модели — плюс два н
|
|||||||
(`SDK\Samples\CSharp.zip`, каталог `Common`); при первом запуске они распаковываются
|
(`SDK\Samples\CSharp.zip`, каталог `Common`); при первом запуске они распаковываются
|
||||||
в `%LOCALAPPDATA%\kompas-mcp\interop\<ключ>`. Если SDK не установлен, укажите каталог
|
в `%LOCALAPPDATA%\kompas-mcp\interop\<ключ>`. Если SDK не установлен, укажите каталог
|
||||||
с этими сборками в переменной окружения `KOMPAS_INTEROP_DIR`;
|
с этими сборками в переменной окружения `KOMPAS_INTEROP_DIR`;
|
||||||
- **[.NET Runtime](https://dotnet.microsoft.com/download/dotnet) 8 или новее, x64** — сервер
|
- **[.NET Runtime](https://dotnet.microsoft.com/download/dotnet) 10 или новее, x64** — сервер
|
||||||
поставляется framework-dependent (2,3 МБ вместо 34), поэтому рантайм берётся с машины.
|
поставляется framework-dependent (2,3 МБ вместо 34), поэтому рантайм берётся с машины.
|
||||||
Проверить: `dotnet --list-runtimes` должен показать `Microsoft.NETCore.App 8.x` или новее;
|
Проверить: `dotnet --list-runtimes` должен показать `Microsoft.NETCore.App 10.x` или новее;
|
||||||
- чекаут и рабочие файлы — вне синхронизируемых папок OneDrive.
|
- чекаут и рабочие файлы — вне синхронизируемых папок OneDrive.
|
||||||
|
|
||||||
Запускать КОМПАС заранее не нужно: сервер присоединится к открытому окну, а если его нет —
|
Запускать КОМПАС заранее не нужно: сервер присоединится к открытому окну, а если его нет —
|
||||||
запустит экземпляр сам.
|
запустит экземпляр сам.
|
||||||
|
|
||||||
## Установка
|
## Установка в 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,40 @@ 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`; версию можно запинить тегом
|
||||||
|
(`pi install git:…@v0.7.4`). Проверка соединения — инструмент `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.5",
|
||||||
|
"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.4.0",
|
"version": "0.7.5",
|
||||||
"description": "Управление КОМПАС-3D из Claude Code: детали, сборки, чертежи, STEP — через MCP-сервер",
|
"description": "Управление КОМПАС-3D из Claude Code: детали, сборки, чертежи, STEP — через MCP-сервер",
|
||||||
"author": {
|
"author": {
|
||||||
"name": "Shahovalov Mikhail",
|
"name": "Shahovalov Mikhail",
|
||||||
|
|||||||
+24
-9
@@ -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`.
|
||||||
|
|
||||||
## Предпосылки
|
## Предпосылки
|
||||||
|
|
||||||
@@ -13,9 +13,9 @@
|
|||||||
сервера не входят и берутся из установки (`SDK\Samples\CSharp.zip`, каталог `Common`). При первом
|
сервера не входят и берутся из установки (`SDK\Samples\CSharp.zip`, каталог `Common`). При первом
|
||||||
запуске они распаковываются в `%LOCALAPPDATA%\kompas-mcp\interop\<ключ>`; если SDK не установлен,
|
запуске они распаковываются в `%LOCALAPPDATA%\kompas-mcp\interop\<ключ>`; если SDK не установлен,
|
||||||
укажите каталог с этими сборками в переменной окружения `KOMPAS_INTEROP_DIR`;
|
укажите каталог с этими сборками в переменной окружения `KOMPAS_INTEROP_DIR`;
|
||||||
- [**.NET Runtime**](https://dotnet.microsoft.com/download/dotnet) **8 или новее, x64** — сервер
|
- [**.NET Runtime**](https://dotnet.microsoft.com/download/dotnet) **10 или новее, x64** — сервер
|
||||||
поставляется framework-dependent, рантайм берётся с машины. Проверка: `dotnet --list-runtimes`
|
поставляется framework-dependent, рантайм берётся с машины. Проверка: `dotnet --list-runtimes`
|
||||||
показывает `Microsoft.NETCore.App 8.x` или новее;
|
показывает `Microsoft.NETCore.App 10.x` или новее;
|
||||||
- чекаут репозитория и рабочие файлы — вне синхронизируемых папок OneDrive.
|
- чекаут репозитория и рабочие файлы — вне синхронизируемых папок OneDrive.
|
||||||
|
|
||||||
## Установка
|
## Установка
|
||||||
@@ -38,6 +38,20 @@
|
|||||||
|
|
||||||
Если инструменты остались прежними — `/reload-plugins`.
|
Если инструменты остались прежними — `/reload-plugins`.
|
||||||
|
|
||||||
|
## Установка в pi
|
||||||
|
|
||||||
|
Тот же прилавок — pi-пакет целиком: расширение регистрирует MCP-сервер, навыки идут вместе.
|
||||||
|
|
||||||
|
```
|
||||||
|
pi install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git
|
||||||
|
pi list
|
||||||
|
```
|
||||||
|
|
||||||
|
Обновление — `pi update --extensions` (git-пакет синхронизируется с веткой, changelog показывается
|
||||||
|
при старте). Версию можно запинить тегом: `pi install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git@v0.7.4`.
|
||||||
|
Проверка соединения — инструмент `kompas_status` (команда `/kompas:doctor` принадлежит Claude Code).
|
||||||
|
Ручная альтернатива без пакета — `adapters/pi/`.
|
||||||
|
|
||||||
## Промпты и ресурсы
|
## Промпты и ресурсы
|
||||||
|
|
||||||
Сервер отдаёт готовые маршруты работы промптами — `part`, `import-edit-export`, `drawing`,
|
Сервер отдаёт готовые маршруты работы промптами — `part`, `import-edit-export`, `drawing`,
|
||||||
@@ -55,11 +69,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,10 +1,10 @@
|
|||||||
# Подключение к 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 8+ x64).
|
в `plugin/bin/`, собирать ничего не нужно (требуется .NET Runtime 10+ x64).
|
||||||
2. Вставить `config.snippet.toml` в `~/.codex/config.toml`, заменив `<PLUGIN>` на абсолютный путь
|
2. Вставить `config.snippet.toml` в `~/.codex/config.toml`, заменив `<PLUGIN>` на абсолютный путь
|
||||||
к каталогу `plugin/` клона. Лаунчер `scripts/launch-kompas-mcp.ps1` — тот же, что у плагина
|
к каталогу `plugin/` клона. Лаунчер `scripts/launch-kompas-mcp.ps1` — тот же, что у плагина
|
||||||
Claude Code.
|
Claude Code.
|
||||||
@@ -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 — отдельная веха.
|
Это сниппет для ручного подключения, а не отдельный дистрибутив.
|
||||||
@@ -1,7 +1,7 @@
|
|||||||
# Подключение к opencode
|
# Подключение к opencode
|
||||||
|
|
||||||
1. Склонировать `https://git.shahovalov.ru/mikhail/kompas-plugin.git` — сервер лежит внутри,
|
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>` на абсолютный путь к
|
2. Слить `opencode.json` со своим конфигом opencode, заменив `<PLUGIN>` на абсолютный путь к
|
||||||
каталогу `plugin/` клона. Используется тот же лаунчер `scripts/launch-kompas-mcp.ps1`.
|
каталогу `plugin/` клона. Используется тот же лаунчер `scripts/launch-kompas-mcp.ps1`.
|
||||||
3. Навыки: скопировать `plugin/skills/{kompas-3d,kompas-fdm-design}` в каталог навыков агента
|
3. Навыки: скопировать `plugin/skills/{kompas-3d,kompas-fdm-design}` в каталог навыков агента
|
||||||
|
|||||||
@@ -0,0 +1,24 @@
|
|||||||
|
# Подключение к pi
|
||||||
|
|
||||||
|
Основной путь — pi-пакет целиком (см. `../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.
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.
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.
+470
-555
File diff suppressed because it is too large.
Load diff
Binary file not shown.
Binary file not shown.
Binary file not shown.
@@ -1,14 +1,15 @@
|
|||||||
{
|
{
|
||||||
"runtimeOptions": {
|
"runtimeOptions": {
|
||||||
"tfm": "net8.0",
|
"tfm": "net10.0",
|
||||||
"rollForward": "LatestMajor",
|
"rollForward": "LatestMajor",
|
||||||
"framework": {
|
"framework": {
|
||||||
"name": "Microsoft.NETCore.App",
|
"name": "Microsoft.NETCore.App",
|
||||||
"version": "8.0.0"
|
"version": "10.0.0"
|
||||||
},
|
},
|
||||||
"configProperties": {
|
"configProperties": {
|
||||||
"System.Reflection.Metadata.MetadataUpdater.IsSupported": false,
|
"System.Reflection.Metadata.MetadataUpdater.IsSupported": false,
|
||||||
"System.Runtime.Serialization.EnableUnsafeBinaryFormatterSerialization": false
|
"System.Runtime.Serialization.EnableUnsafeBinaryFormatterSerialization": false,
|
||||||
|
"CSWINRT_USE_WINDOWS_UI_XAML_PROJECTIONS": false
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -28,9 +28,9 @@ description: "Диагностика установки плагина КОМП
|
|||||||
`/plugin update kompas@kompas-plugin`, затем `/reload-plugins`.
|
`/plugin update kompas@kompas-plugin`, затем `/reload-plugins`.
|
||||||
|
|
||||||
4. **.NET Runtime.** Сервер поставляется framework-dependent, поэтому рантайм нужен на машине:
|
4. **.NET Runtime.** Сервер поставляется framework-dependent, поэтому рантайм нужен на машине:
|
||||||
`dotnet --list-runtimes` должен показать строку `Microsoft.NETCore.App 8.<любая>` или новее
|
`dotnet --list-runtimes` должен показать строку `Microsoft.NETCore.App 10.<любая>` или новее
|
||||||
(x64). Ни одной подходящей строки или самой команды `dotnet` нет — это и есть причина сбоя
|
(x64). Ни одной подходящей строки или самой команды `dotnet` нет — это и есть причина сбоя
|
||||||
пункта 3: попроси пользователя поставить .NET Runtime 8 или новее с
|
пункта 3: попроси пользователя поставить .NET Runtime 10 или новее с
|
||||||
https://dotnet.microsoft.com/download/dotnet (нужен именно x64; Desktop Runtime не обязателен).
|
https://dotnet.microsoft.com/download/dotnet (нужен именно x64; Desktop Runtime не обязателен).
|
||||||
|
|
||||||
5. **КОМПАС-3D установлен и, возможно, уже запущен.** Сервер подключается к КОМПАС лениво — не при
|
5. **КОМПАС-3D установлен и, возможно, уже запущен.** Сервер подключается к КОМПАС лениво — не при
|
||||||
|
|||||||
@@ -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.5",
|
||||||
|
"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"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -40,7 +40,7 @@ catch {
|
|||||||
# Самая частая причина здесь — отсутствующий .NET Runtime: сервер поставляется
|
# Самая частая причина здесь — отсутствующий .NET Runtime: сервер поставляется
|
||||||
# framework-dependent, и без рантайма apphost падает именно тут.
|
# framework-dependent, и без рантайма apphost падает именно тут.
|
||||||
[Console]::Error.WriteLine("kompas-mcp launcher: не удалось запустить сервер: $($_.Exception.Message)")
|
[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
|
exit 1
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -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")` |
|
||||||
|
|
||||||
Их **сочетают в одной детали**: корпусные объёмы — примитивами, сложные контуры — эскизами.
|
Их **сочетают в одной детали**: корпусные объёмы — примитивами, сложные контуры — эскизами.
|
||||||
|
|
||||||
@@ -321,8 +331,8 @@ variables | errors | components` (`sections` сужает и ответ, и об
|
|||||||
файл детали не меняется — но он перекрывает ВСЕ акценты детали (надпись станет цвета
|
файл детали не меняется — но он перекрывает ВСЕ акценты детали (надпись станет цвета
|
||||||
компонента). Нужны акценты — оставь компоненту наследуемый цвет. Грань или тело ВНУТРИ
|
компонента). Нужны акценты — оставь компоненту наследуемый цвет. Грань или тело ВНУТРИ
|
||||||
компонента из сборки не красятся: акценты, общие для всех экземпляров, задают в файле детали.
|
компонента из сборки не красятся: акценты, общие для всех экземпляров, задают в файле детали.
|
||||||
- **Передача дальше**: STEP несёт цвета и прозрачность — ответ `export_model` их перечисляет; STL
|
- **Передача дальше**: STEP несёт цвета и прозрачность, но не текстуры и вырезы; STL не несёт
|
||||||
цветов не несёт.
|
оформления вовсе. Ответ `export_model` перечисляет попавшие цвета и называет, что потеряно.
|
||||||
- **Отделка по материалу**: металл — `finish="metal"` (`silver`, `gold`), пластик — `satin` или
|
- **Отделка по материалу**: металл — `finish="metal"` (`silver`, `gold`), пластик — `satin` или
|
||||||
`matte`, `glossy` — умолчание КОМПАС.
|
`matte`, `glossy` — умолчание КОМПАС.
|
||||||
- **Текстура — там, где она что-то говорит**: накатка на рукоятке (`texture="diamond knurl"`,
|
- **Текстура — там, где она что-то говорит**: накатка на рукоятке (`texture="diamond knurl"`,
|
||||||
@@ -336,8 +346,7 @@ variables | errors | components` (`sections` сужает и ответ, и об
|
|||||||
на снимке, не трогая массу и топологию. Нужны настоящие отверстия под крепёж или DFM — это
|
на снимке, не трогая массу и топологию. Нужны настоящие отверстия под крепёж или DFM — это
|
||||||
`hole`/`pattern`, вырез их не заменяет. Рисунок «не тем боком» — `textureAngle`, сдвиг —
|
`hole`/`pattern`, вырез их не заменяет. Рисунок «не тем боком» — `textureAngle`, сдвиг —
|
||||||
`textureOffset` (оба вместе с повтором имён `texture` и `cutout` — повернётся только то, что
|
`textureOffset` (оба вместе с повтором имён `texture` и `cutout` — повернётся только то, что
|
||||||
названо в вызове; поворот 0…180°). Смена рисунка плитку и раскладку сохраняет. В STEP уходят
|
названо в вызове; поворот 0…180°). Смена рисунка плитку и раскладку сохраняет.
|
||||||
только цвета — текстуры и вырезы остаются в `.m3d`.
|
|
||||||
- **Проверка — глазами**: `model_snapshot(view="iso")` после раскраски; что окрашено на самом
|
- **Проверка — глазами**: `model_snapshot(view="iso")` после раскраски; что окрашено на самом
|
||||||
деле — `describe_model(sections=appearance)`. Прозрачность снимок не рисует — её видно только
|
деле — `describe_model(sections=appearance)`. Прозрачность снимок не рисует — её видно только
|
||||||
в разделе `appearance`.
|
в разделе `appearance`.
|
||||||
|
|||||||
@@ -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.4.0",
|
"version": "0.7.5",
|
||||||
"tag": "v0.4.0",
|
"tag": "v0.7.5",
|
||||||
"sourceSha": "f1ecc6ff5a923d524a7aa8dc7b97c538d9cf1bb3",
|
"sourceSha": "9c10372ffcb666fd32090e411d434fb1b8faa71f",
|
||||||
"built": "2026-10-15T03:15:33Z"
|
"built": "2026-11-03T18:58:34Z"
|
||||||
}
|
}
|
||||||
Reference in new issue
Block a user