5 Commits
19 changed files with 211 additions and 27 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" }
}
]
}
+29 -5
View File
@@ -1,4 +1,4 @@
# КОМПАС-3D в Claude Code
# КОМПАС-3D в Claude Code, Codex и pi
Каталог плагинов с одним плагином — **`kompas`**. Он даёт Claude Code управление
[КОМПАС-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
@@ -35,7 +35,7 @@ STEP/STL, осмотр и измерение модели — плюс два н
`/kompas:doctor` — диагностика: версия сервера, установлен ли КОМПАС, на месте ли interop-сборки,
проходит ли соединение. С неё стоит начинать разбор любой неполадки.
## Обновление
## Обновление в Claude Code
```
/plugin marketplace update kompas-plugin
@@ -54,10 +54,34 @@ STEP/STL, осмотр и измерение модели — плюс два н
| **Команда `/kompas:doctor`** | диагностика установки |
| **Справка `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 — сниппеты конфигурации лежат в
`plugin/adapters/{codex,opencode}/`.
Тот же сервер можно подключить вручную к Codex, opencode и pi — сниппеты конфигурации лежат в
`plugin/adapters/{codex,opencode,pi}/`.
## Лицензия
+24
View File
@@ -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 -1
View File
@@ -1,7 +1,7 @@
{
"name": "kompas",
"displayName": "КОМПАС-3D",
"version": "0.7.0",
"version": "0.7.5",
"description": "Управление КОМПАС-3D из Claude Code: детали, сборки, чертежи, STEP — через MCP-сервер",
"author": {
"name": "Shahovalov Mikhail",
+22 -7
View File
@@ -1,7 +1,7 @@
# Плагин `kompas` — КОМПАС-3D в Claude Code
# Плагин `kompas` — КОМПАС-3D в Claude Code, Codex и pi
Даёт Claude Code инструменты управления КОМПАС-3D (детали, сборки, чертежи, STEP) и методику работы
с ними: навыки `kompas:kompas-3d` и `kompas:kompas-fdm-design`.
Даёт агенту инструменты управления КОМПАС-3D (детали, сборки, чертежи, STEP) и методику работы
с ними: навыки `kompas-3d` и `kompas-fdm-design`.
## Предпосылки
@@ -38,6 +38,20 @@
Если инструменты остались прежними — `/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`,
@@ -55,11 +69,12 @@ $env:KOMPAS_MCP_EXE = "<путь>\kompas-mcp.exe"
Тогда лаунчер `scripts/launch-kompas-mcp.ps1` не смотрит в `bin/` плагина.
## Другие харнессы (Codex, opencode)
## Другие харнессы (Codex, opencode, pi)
Тот же лаунчер подключается и к другим агентским харнессам — см. `adapters/codex/` и
`adapters/opencode/`. Это сниппеты конфигурации и инструкция, а не отдельные дистрибутивы:
контент (навыки, лаунчер) не размножается, новый харнесс стоит README + сниппета.
Тот же лаунчер подключается и к другим агентским харнессам — см. `adapters/codex/`,
`adapters/opencode/` и `adapters/pi/`. Это сниппеты конфигурации и инструкция, а не отдельные
дистрибутивы: контент (навыки, лаунчер) не размножается, новый харнесс стоит README + сниппета.
Для pi основной путь — pi-пакет (`package.json` в корне прилавка, расширение `plugin/pi/kompas.ts`).
## Прочее
+3 -3
View File
@@ -1,7 +1,7 @@
# Подключение к Codex
Codex не знает ни маркетплейсов, ни `${CLAUDE_PLUGIN_ROOT}`, поэтому подключение делается по пути
к каталогу плагина.
Плагин можно установить из каталога `kompas-plugin`: см. README публичного репозитория.
Инструкция ниже — альтернативное ручное подключение без плагина.
1. Склонировать `https://git.shahovalov.ru/mikhail/kompas-plugin.git` — сервер лежит внутри,
в `plugin/bin/`, собирать ничего не нужно (требуется .NET Runtime 10+ x64).
@@ -17,4 +17,4 @@ Codex не знает ни маркетплейсов, ни `${CLAUDE_PLUGIN_ROO
Свой собранный сервер подставляется переменной окружения `KOMPAS_MCP_EXE` — она перекрывает
`plugin/bin/kompas-mcp.exe`.
Это сниппет и инструкция, а не дистрибутив: полноценный плагин Codex — отдельная веха.
Это сниппет для ручного подключения, а не отдельный дистрибутив.
+24
View File
@@ -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`.
Это сниппет и инструкция, а не дистрибутив.
+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, осмотр модели"
}
}
}
Binary file not shown.
Binary file not shown.
+7 -7
View File
@@ -7,9 +7,9 @@
"targets": {
".NETCoreApp,Version=v10.0": {},
".NETCoreApp,Version=v10.0/win-x64": {
"kompas-mcp/0.7.0": {
"kompas-mcp/0.7.5": {
"dependencies": {
"Kompas.Mcp.Core": "0.7.0",
"Kompas.Mcp.Core": "0.7.5",
"Microsoft.Extensions.Hosting": "10.0.14",
"ModelContextProtocol": "2.3.0"
},
@@ -433,21 +433,21 @@
}
}
},
"Kompas.Mcp.Core/0.7.0": {
"Kompas.Mcp.Core/0.7.5": {
"dependencies": {
"Microsoft.Extensions.Logging.Abstractions": "10.0.14"
},
"runtime": {
"Kompas.Mcp.Core.dll": {
"assemblyVersion": "0.7.0.0",
"fileVersion": "0.7.0.0"
"assemblyVersion": "0.7.5.0",
"fileVersion": "0.7.5.0"
}
}
}
}
},
"libraries": {
"kompas-mcp/0.7.0": {
"kompas-mcp/0.7.5": {
"type": "project",
"serviceable": false,
"sha512": ""
@@ -676,7 +676,7 @@
"path": "system.diagnostics.eventlog/10.0.14",
"hashPath": "system.diagnostics.eventlog.10.0.14.nupkg.sha512"
},
"Kompas.Mcp.Core/0.7.0": {
"Kompas.Mcp.Core/0.7.5": {
"type": "project",
"serviceable": false,
"sha512": ""
Binary file not shown.
Binary file not shown.
Binary file not shown.
+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",
});
}
+21
View File
@@ -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"
}
}
}
}
+8
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` сужает и ответ, и объём чтения модели). Углубляться —
+4 -4
View File
@@ -1,6 +1,6 @@
{
"version": "0.7.0",
"tag": "v0.7.0",
"sourceSha": "a6762d2bdacc62d93705b5c59586ec471854775c",
"built": "2026-10-27T22:15:59Z"
"version": "0.7.5",
"tag": "v0.7.5",
"sourceSha": "9c10372ffcb666fd32090e411d434fb1b8faa71f",
"built": "2026-11-03T18:58:34Z"
}