Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
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" }
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -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
|
||||
@@ -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-fdm-design`** | проектирование под FDM/FFF-печать: нависания, толщины стенок, зазоры и посадки, ориентация, бобышки и защёлки |
|
||||
| **Команда `/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}/`.
|
||||
|
||||
## Лицензия
|
||||
|
||||
|
||||
@@ -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",
|
||||
"displayName": "КОМПАС-3D",
|
||||
"version": "0.5.0",
|
||||
"version": "0.7.5",
|
||||
"description": "Управление КОМПАС-3D из Claude Code: детали, сборки, чертежи, STEP — через MCP-сервер",
|
||||
"author": {
|
||||
"name": "Shahovalov Mikhail",
|
||||
|
||||
+22
-7
@@ -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`).
|
||||
|
||||
## Прочее
|
||||
|
||||
|
||||
@@ -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 — отдельная веха.
|
||||
Это сниппет для ручного подключения, а не отдельный дистрибутив.
|
||||
@@ -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": {
|
||||
".NETCoreApp,Version=v10.0": {},
|
||||
".NETCoreApp,Version=v10.0/win-x64": {
|
||||
"kompas-mcp/0.5.0": {
|
||||
"kompas-mcp/0.7.5": {
|
||||
"dependencies": {
|
||||
"Kompas.Mcp.Core": "0.5.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.5.0": {
|
||||
"Kompas.Mcp.Core/0.7.5": {
|
||||
"dependencies": {
|
||||
"Microsoft.Extensions.Logging.Abstractions": "10.0.14"
|
||||
},
|
||||
"runtime": {
|
||||
"Kompas.Mcp.Core.dll": {
|
||||
"assemblyVersion": "0.5.0.0",
|
||||
"fileVersion": "0.5.0.0"
|
||||
"assemblyVersion": "0.7.5.0",
|
||||
"fileVersion": "0.7.5.0"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"libraries": {
|
||||
"kompas-mcp/0.5.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.5.0": {
|
||||
"Kompas.Mcp.Core/0.7.5": {
|
||||
"type": "project",
|
||||
"serviceable": false,
|
||||
"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`** — паспорт
|
||||
одним запросом и ЕДИНСТВЕННЫЙ инструмент осмотра: разделы `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")` |
|
||||
|
||||
Их **сочетают в одной детали**: корпусные объёмы — примитивами, сложные контуры — эскизами.
|
||||
|
||||
|
||||
@@ -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
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"version": "0.5.0",
|
||||
"tag": "v0.5.0",
|
||||
"sourceSha": "29b0f1188a1ddafad5b49076f73d75239bd9bc76",
|
||||
"built": "2026-10-26T20:45:56Z"
|
||||
"version": "0.7.5",
|
||||
"tag": "v0.7.5",
|
||||
"sourceSha": "9c10372ffcb666fd32090e411d434fb1b8faa71f",
|
||||
"built": "2026-11-03T18:58:34Z"
|
||||
}
|
||||
Reference in new issue
Block a user