Даёт Claude Code инструменты управления КОМПАС-3D (детали, сборки, чертежи, STEP) и методику работы с ними: навыки kompas:kompas-3d и kompas:kompas-fdm-design.

Предпосылки

Windows x64;
установленный КОМПАС-3D (проверено на v24 Home) — сервер является COM-клиентом, а не автономным CAD-движком, и работает только на той же машине. Запускать заранее не нужно: сервер присоединится к открытому окну, а если его нет — запустит экземпляр сам;
КОМПАС установлен вместе с компонентом SDK: interop-сборки принадлежат АСКОН, в поставку сервера не входят и берутся из установки (SDK\Samples\CSharp.zip, каталог Common). При первом запуске они распаковываются в %LOCALAPPDATA%\kompas-mcp\interop\<ключ>; если SDK не установлен, укажите каталог с этими сборками в переменной окружения KOMPAS_INTEROP_DIR;
.NET Runtime 8 или новее, x64 — сервер поставляется framework-dependent, рантайм берётся с машины. Проверка: dotnet --list-runtimes показывает Microsoft.NETCore.App 8.x или новее;
чекаут репозитория и рабочие файлы — вне синхронизируемых папок OneDrive.

Установка

/plugin marketplace add https://git.shahovalov.ru/mikhail/kompas-plugin.git
/plugin install kompas@kompas-plugin
/kompas:doctor

Сервер (bin/kompas-mcp.exe) едет вместе с плагином — отдельно скачивать и устанавливать нечего. /kompas:doctor проверяет версию, наличие .NET и КОМПАС, interop-сборки и соединение.

Обновление

/plugin marketplace update kompas-plugin
/plugin update kompas@kompas-plugin

Если инструменты остались прежними — /reload-plugins.

Разработка сервера

Переменная окружения KOMPAS_MCP_EXE подменяет поставленный бинарь своим:

$env:KOMPAS_MCP_EXE = "<путь>\kompas-mcp.exe"

Тогда лаунчер scripts/launch-kompas-mcp.ps1 не смотрит в bin/ плагина.

Другие харнессы (Codex, opencode)

Тот же лаунчер подключается и к другим агентским харнессам — см. adapters/codex/ и adapters/opencode/. Это сниппеты конфигурации и инструкция, а не отдельные дистрибутивы: контент (навыки, лаунчер) не размножается, новый харнесс стоит README + сниппета.

Прочее

Каталог %LOCALAPPDATA%\kompas-mcp (распакованные interop-сборки, при разработке — временные файлы) не очищается при обновлении и удалении плагина — удаляется вручную.

README.md