Skip to main content
Glama
KOMPAS Engineering MCP

KOMPAS Engineering MCP

KOMPAS Engineering MCP

English · Статус возможностей · Исследование

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

Первый запуск на Windows

Установите uv, Python 3.12+ и лицензированный КОМПАС с зарегистрированными библиотеками API. Распакуйте или клонируйте проект в свой каталог. В 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. Установщик не редактирует конфигурацию клиента.

Related MCP server: kompas3d

Экспериментальная запись

Оператор задаёт 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 только для живого теста. Объявление режима записи само по себе не подтверждает совместимость.

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}. Сборки, изменение существующих параметров, чертежи и промышленная квалификация остаются открытыми задачами. Спецификация и задачи.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI hosts to interact with a browser CAD workbench through model-neutral local stdio or authenticated remote MCP tools, supporting command discovery, design-health analysis, and scoped previews while never reading local files or taking over open sessions.
      MIT
    • A
      license
      C
      quality
      C
      maintenance
      Enables AI agents to create and edit native KOMPAS-3D models from text descriptions, drawings, or PDFs, with parameterization, assemblies, drawings, and export to STEP, STL, and IGES.
      41
      13
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Enables AI agents or local operators to inspect, plan, execute, and verify bounded KOMPAS-3D CAD operations, including sketch and feature editing, parametric parts, springs, transmissions, specifications, relinking, quality checks, and safe exports.
      118
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI clients such as Claude Desktop, Cursor, and Copilot to connect over MCP STDIO to CAD/CAE/CAM tooling for natural-language parametric shape synthesis, CSG script generation, solid watertightness validation, error analysis, and autonomous correction.
      MIT