5 Commits
15 changed files with 81 additions and 21 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" }
}
]
}
+18 -5
View File
@@ -1,4 +1,4 @@
# КОМПАС-3D в Claude Code # КОМПАС-3D в Claude Code и Codex
Каталог плагинов с одним плагином — **`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,15 +48,28 @@ 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`.
## Другие агентские харнессы ## Другие агентские харнессы
Тот же сервер подключается к Codex и opencode — сниппеты конфигурации лежат в Тот же сервер можно подключить вручную к Codex и opencode — сниппеты конфигурации лежат в
`plugin/adapters/{codex,opencode}/`. `plugin/adapters/{codex,opencode}/`.
## Лицензия ## Лицензия
+1 -1
View File
@@ -1,7 +1,7 @@
{ {
"name": "kompas", "name": "kompas",
"displayName": "КОМПАС-3D", "displayName": "КОМПАС-3D",
"version": "0.5.0", "version": "0.7.3",
"description": "Управление КОМПАС-3D из Claude Code: детали, сборки, чертежи, STEP — через MCP-сервер", "description": "Управление КОМПАС-3D из Claude Code: детали, сборки, чертежи, STEP — через MCP-сервер",
"author": { "author": {
"name": "Shahovalov Mikhail", "name": "Shahovalov Mikhail",
+3 -3
View File
@@ -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 — отдельная веха. Это сниппет для ручного подключения, а не отдельный дистрибутив.
Binary file not shown.
Binary file not shown.
+7 -7
View File
@@ -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.3": {
"dependencies": { "dependencies": {
"Kompas.Mcp.Core": "0.5.0", "Kompas.Mcp.Core": "0.7.3",
"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.3": {
"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.3.0",
"fileVersion": "0.5.0.0" "fileVersion": "0.7.3.0"
} }
} }
} }
} }
}, },
"libraries": { "libraries": {
"kompas-mcp/0.5.0": { "kompas-mcp/0.7.3": {
"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.3": {
"type": "project", "type": "project",
"serviceable": false, "serviceable": false,
"sha512": "" "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"]
}
}
}
+21
View File
@@ -0,0 +1,21 @@
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "kompas",
"version": "0.7.3",
"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"
}
}
}
}
+2
View File
@@ -153,6 +153,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
View File
@@ -1,6 +1,6 @@
{ {
"version": "0.5.0", "version": "0.7.3",
"tag": "v0.5.0", "tag": "v0.7.3",
"sourceSha": "29b0f1188a1ddafad5b49076f73d75239bd9bc76", "sourceSha": "a97aed3a4a3be2c4a97ac53122f0694a23ae6194",
"built": "2026-10-26T20:45:56Z" "built": "2026-11-03T16:25:52Z"
} }