Skip to main content
Glama
KOMPAS Engineering MCP

KOMPAS Engineering MCP

README.md
# KOMPAS Engineering MCP

[English](README.en.md) · [Статус возможностей](COMPATIBILITY.md) · [Исследование](docs/COMPETITIVE_ANALYSIS.md)

Локальный MCP-сервер для КОМПАС-3D. Текущая ревизия предназначена для разработки и испытаний. Проверены автономное планирование, контроль заданий и взаимодействие клиента и сервера по stdio. Подтверждённых версий CAD пока нет.

## Первый запуск на Windows
Установите uv, Python 3.12+ и лицензированный КОМПАС с зарегистрированными библиотеками API. Распакуйте или клонируйте проект в свой каталог. В PowerShell выполните:

~~~powershell
.\install.ps1
codex mcp add kompas -- "$PWD\.venv\Scripts\kompas-mcp.exe"
codex mcp list
~~~

Перезапустите сессию Codex. Попросите: «Вызови kompas_status и kompas_capabilities. Прочитай examples/plate.json и передай содержимое как spec в kompas_model_plan. Покажи порядок построения и предположения». Настройки Claude Desktop, Cursor и Codex находятся в clients/. Подставьте абсолютный путь своего checkout. Установщик не редактирует конфигурацию клиента.

## Экспериментальная запись
Оператор задаёт KOMPAS_ALLOW_BUILD=1 в окружении сервера. Для анализируемых файлов задайте KOMPAS_INPUT_ROOT, для локальной HTML-справки — KOMPAS_SDK_HELP. KOMPAS_STATE указывает на закрытый для посторонней записи каталог заданий. Начните с чистого тестового сеанса Windows. Вызовите kompas_model_apply с уникальным UUID и дайджестом из плана, затем kompas_operation_status. Candidate-файл хранится внутри каталога UUID. После прерывания проверьте состояние задания перед новой командой.

Для испытания габаритов задайте KOMPAS_BOUNDS_UNCERTAINTY_MM по результатам калибровки своего стенда. Без известной погрешности сервер оставляет измерение неподтверждённым. Сохраните KOMPAS_BUILD_LABEL и используйте KOMPAS_LIVE=1 только для живого теста. Объявление режима записи само по себе не подтверждает совместимость.
~~~powershell
uv sync --locked
uv run pytest tests/offline
uv run pytest tests/live --basetemp .\live-results-new
~~~
Для --basetemp используйте отдельный пустой каталог: pytest очищает его. Файлы заданий и клиентские настройки сохраняются при удалении окружения через uninstall.ps1.

## Реализованные инструменты
|Инструмент|Результат|
|---|---|
|kompas_status|Среда, доступ к записи и список квалифицированных версий|
|kompas_capabilities|Проверка регистрации type libraries в Windows|
|kompas_document_inspect|Чтение имён и типов открытых документов через API7 активного сеанса|
|kompas_model_plan|Порядок и размеры прямоугольного профиля с круглыми отверстиями и выдавливания|
|kompas_model_apply|Экспериментальное построение новой детали через API5|
|kompas_operation_status|Сохранённый результат и состояние задания по UUID|
|kompas_snapshot|SHA-256 существующего файла CAD|
|kompas_diff|Различия двух спецификаций|
|kompas_sdk_search, kompas_sdk_describe|Поиск тем и чтение установленной HTML-справки|
|kompas_stl_inspect|Габариты, рёбра, ориентация и площадь направленных вниз треугольников бинарного STL|

Отчёт задания доступен как MCP resource kompas://reports/{operation_id}. Сборки, изменение существующих параметров, чертежи и промышленная квалификация остаются открытыми задачами. [Спецификация и задачи](specs/001-engineering-core/tasks.md).