kompas3d-mcp

MCP-сервер, который позволяет ИИ-ассистенту (Claude Desktop, Claude Code и любому другому MCP-клиенту) управлять КОМПАС-3D через COM API: открывать и сохранять документы, строить детали, собирать и перемещать компоненты, измерять модели и создавать размеренные чертежи.

English version: README.en.md

Неофициальный проект. КОМПАС-3D — продукт и товарный знак АСКОН. Репозиторий не связан с АСКОН и не содержит кода или файлов SDK АСКОН.

Для кого

Для конструкторов и инженеров по автоматизации САПР, которые уже работают в КОМПАС-3D и хотят передать ассистенту рутину (вставить 50 крепежей, проверить состав изделия, сделать первый вариант чертежа). Каждый результат проверяется числами (габарит, масса, число тел), а не принимается на слово.

Related MCP server: kompas3d

Требования

• Windows 10/11

• КОМПАС-3D v23 (единственная версия, на которой разрабатывалось и проверялось)

• Python 3.10 и новее (разработка на 3.12)

• Пакеты из requirements.txt: mcp (1.x), pywin32, Pillow, numpy, jsonschema

Сервер обращается к запущенному КОМПАС через COM, поэтому работает на той же машине Windows и под тем же пользователем, что и КОМПАС.

Установка

git clone https://github.com/semyyon/kompas3d-mcp.git
cd kompas3d-mcp
python -m venv .venv
.venv\Scripts\python -m pip install -r requirements.txt

Проверка, что сервер запускается (КОМПАС он сам не стартует):

.venv\Scripts\python -c "import server; print(server.kompas_status())"

Подключение к MCP-клиенту

Любому клиенту нужна команда, запускающая server.py по stdio. Пути абсолютные; в примерах репозиторий лежит в C:\tools\kompas3d-mcp.

Claude Desktop — claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "kompas3d": {
      "command": "C:\\tools\\kompas3d-mcp\\.venv\\Scripts\\python.exe",
      "args": ["C:\\tools\\kompas3d-mcp\\server.py"]
    }
  }
}

Claude Code:

claude mcp add kompas3d -- C:\tools\kompas3d-mcp\.venv\Scripts\python.exe C:\tools\kompas3d-mcp\server.py

Другие клиенты (Cursor, Cline и т. п.) принимают ту же пару command / args в настройках MCP.

Необязательные переменные окружения:

Инструменты

Примеры запросов

• «Открой Bracket.m3d, задай материал Сталь 12Х18Н10Т и доложи габарит, массу и число тел».

• «Вставь M6x20.m3d 24 раза в открытую сборку по этим координатам и покажи аудит крепежа».

• «Проверь сборку на пересечения тел и перечисли пары».

• «Построй чертёж Plate.m3d по этому spec и исправь всё, что покажет kompas_check_drawing».

• «Каким методом KOMPAS API задаётся глубина выдавливания? Найди в справке SDK».

Как устроено

• server.py — сервер FastMCP по stdio.

• К КОМПАС подключается через pywin32 по обоим COM API: API7 (IApplication) и API5 (KompasObject).

• Экземпляр КОМПАС один, поэтому доступ защищён межпроцессной блокировкой; kompas_batch держит её на всю цепочку.

• Изменяющие инструменты принимают document=, чтобы правка не ушла в документ, который КОМПАС сделал активным сам.

• jobs/ — именованные скрипты для kompas_run_job; jobs/_draw.py — движок 2D-чертежей.

• Чертежи задаются JSON-spec (схема, примеры); проверки в drawing_rules.py, настраиваемые пороги и типовые тексты — в project_rules.json.

• hooks/ — необязательные хуки Claude Code, например запрет сохранять сборку без свежей резервной копии.

• Каждый вызов замеряется и пишется в logs/calls.jsonl.

Ограничения

• Только Windows и КОМПАС-3D v23. Другие версии могут работать, но не проверялись.

• Описания инструментов частично на русском, правила чертежей следуют ЕСКД/ГОСТ. В project_rules.json — значения автора; под свои стандарты их нужно править.

• Stub-файлы SDK и архив справки принадлежат АСКОН и не включены. Без них kompas_api опирается на установленные библиотеки типов, а для kompas_sdk_search нужен KOMPAS_SDK_HELP_ZIP.

• Некоторые операции КОМПАС открывают модальные диалоги, блокирующие COM; см. kompas_auto_dialogs.

• kompas_run_script выполняет произвольный код с правами вашего пользователя. Подключайте только доверенные клиенты.

Разработка

.venv\Scripts\python -m pip install -r requirements-dev.txt
.venv\Scripts\python -m pytest

Тесты не требуют КОМПАС; те, которым он нужен, пропускаются автоматически. См. CONTRIBUTING.md.

Благодарности

Model Context Protocol и его Python SDK, pywin32. Разработано вместе с Claude.

Лицензия

MIT