Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
ef953f6e4b | ||
|
|
d514b45b88 | ||
|
|
a89c68491f | ||
|
|
3340b9ecf7 | ||
|
|
0a1d3f710d |
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-сервер: детали, эскизы,
|
||||||
@@ -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
|
||||||
@@ -54,10 +54,34 @@ STEP/STL, осмотр и измерение модели — плюс два н
|
|||||||
| **Команда `/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.7.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",
|
||||||
|
|||||||
+22
-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,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,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.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.7.0": {
|
"kompas-mcp/0.7.5": {
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"Kompas.Mcp.Core": "0.7.0",
|
"Kompas.Mcp.Core": "0.7.5",
|
||||||
"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.7.0": {
|
"Kompas.Mcp.Core/0.7.5": {
|
||||||
"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.7.0.0",
|
"assemblyVersion": "0.7.5.0",
|
||||||
"fileVersion": "0.7.0.0"
|
"fileVersion": "0.7.5.0"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"libraries": {
|
"libraries": {
|
||||||
"kompas-mcp/0.7.0": {
|
"kompas-mcp/0.7.5": {
|
||||||
"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.7.0": {
|
"Kompas.Mcp.Core/0.7.5": {
|
||||||
"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.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"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -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` сужает и ответ, и объём чтения модели). Углубляться —
|
||||||
|
|||||||
+4
-4
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"version": "0.7.0",
|
"version": "0.7.5",
|
||||||
"tag": "v0.7.0",
|
"tag": "v0.7.5",
|
||||||
"sourceSha": "a6762d2bdacc62d93705b5c59586ec471854775c",
|
"sourceSha": "9c10372ffcb666fd32090e411d434fb1b8faa71f",
|
||||||
"built": "2026-10-27T22:15:59Z"
|
"built": "2026-11-03T18:58:34Z"
|
||||||
}
|
}
|
||||||
Reference in new issue
Block a user