Kompas3D MCP
README.md
# Kompas3D MCP
**MCP-сервер для КОМПАС-3D v24: ИИ-агент строит и проверяет настоящие детали и сборки, а сервер
отвечает тем, что измерил на модели, а не тем, что вызов «прошёл».**
[](LICENSE)





Подключите сервер к ИИ-агенту (Codex, Claude или другому MCP-клиенту), и агент будет работать в
вашем КОМПАС-3D: строить детали по чертежу, править их, собирать сборки, выпускать чертежи и
выгружать STEP и DXF. После каждого шага сервер перечитывает модель и сообщает, что именно
подтверждено измерением.
> *English summary.* An MCP server that lets an AI agent drive a real, licensed KOMPAS-3D v24 (x64):
> parts, sketches, features, assemblies and mates (including component patterns and nested components),
> a bill of materials with CSV/JSON export, component properties, native model specification rows
> (create, edit, delete) and specification documents (`.spw`, read), drawings, sheet metal, direct face
> editing (move, delete, restore), stiffening ribs, counterbored, countersunk, spherical-bottom and
> conical holes, STEP/DXF/IGES export. Every mutating call reports a measured verification level, is
> journaled for safe retries and is confined to configured disk roots. No arbitrary code execution.
> Dual-licensed MIT / Apache-2.0. Documentation is in Russian.
## Быстрая установка
Нужны Windows x64, установленный и лицензированный **КОМПАС-3D v24 x64** и **.NET 10 Runtime x64**.
Скопируйте агенту одну фразу - он сам скачает пакет из Releases, сверит контрольную сумму, создаст
конфигурацию и подключит сервер. Разрешите ему скачивание и запуск установщика, когда он спросит.
<p>
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/assets/openai-blossom-white-tight.svg">
<img src="docs/assets/openai-blossom-black-tight.svg" alt="Логотип OpenAI" height="40" align="absmiddle">
</picture>
<b><a href="https://developers.openai.com/codex">ChatGPT Codex</a></b>
</p>
```text
https://github.com/SergeySklyarov/Kompas3D-MCP
Установи и подключи последнюю принятую версию KompasMCP из этого репозитория на этой Windows-машине по инструкции docs/operator-guide/codex-setup.md; проверь зависимости, checksum и доступность инструментов; мои модели не изменяй.
```
<p>
<img src="docs/assets/claude-spark-clay.svg" alt="Логотип Claude" height="40" align="absmiddle">
<b><a href="https://code.claude.com">Claude Code</a></b>
</p>
```text
https://github.com/SergeySklyarov/Kompas3D-MCP
Установи и подключи последнюю принятую версию KompasMCP из этого репозитория на этой Windows-машине по инструкции docs/operator-guide/claude-setup.md; проверь зависимости, checksum и доступность инструментов; мои модели не изменяй.
```
После установки перезапустите клиент и в новом чате попросите «вызови kompas_health и
kompas_capabilities»: сервер ответит версией и списком инструментов. Подробно:
[Codex](docs/operator-guide/codex-setup.md), [Claude](docs/operator-guide/claude-setup.md),
[другой MCP-клиент и ручная установка](docs/operator-guide/install.md),
[сборка из исходников](docs/operator-guide/build.md).
## Пример: деталь по чертежу, собранная агентом
Агенту дают чертёж и задачу, и он строит деталь сам, вызовами инструментов этого сервера. Каждый
шаг сервер подтверждает измерением.

*Слева чертёж задания конкурса **Model Mania 2021** (SOLIDWORKS; права на чертёж принадлежат
SOLIDWORKS). В центре дерево построения в КОМПАС-3D, которое агент (**ChatGPT 6.0 Astra, режим
размышлений Low**) собрал сам, и модель; справа та же деталь с обратной стороны.*
## Что умеет
- **Детали.** Эскизы, выдавливание, вращение, по траектории и по сечениям, оболочка, скругления,
фаски, отверстия, резьба, уклоны, булевы операции, массивы.
- **Правка, а не пересоздание.** Параметры существующего признака читаются и меняются на месте;
признак можно подавить, восстановить или удалить.
- **Прямая правка граней.** Грани тела сдвигаются вдоль своей нормали, удаляются в двух режимах и
восстанавливаются поверхностью по грани, без правки дерева построения.
- **Рёбра жёсткости и отверстия.** Ребро по разомкнутой цепочке эскиза с односторонней или
симметричной толщиной и уклоном; отверстия с цековкой, зенковкой, сферическим дном, конусом
насквозь и выточкой с зенковкой.
- **Сборки.** Вставка, замена и размещение компонентов, включая компонент внутри подсборки;
массивы компонентов по сетке, окружности и кривой; сопряжения, включая «симметрию» и «зависимое
положение»; разнесённый вид, сечения, проверка пересечений и зазоров.
- **Состав изделия (BOM) и спецификации.** Сводная ведомость сборки с деревом и количествами, её
выгрузка в CSV и JSON, свойства компонента по ссылке; чтение родной спецификации модели и
документа-спецификации `.spw`, создание, правка и удаление строки спецификации модели.
- **Листовой металл.** Листовое тело, сгибы, отверстия и вырезы, развёртка и её выгрузка в DXF.
- **Чертежи.** Ассоциативные виды, разрезы, размеры (у диаметрального ответ называет и число на
чертеже), основная надпись, технические требования, которые вписываются в свободное место листа,
экспорт в DXF/DWG.
- **Переменные и материал.** Внешние переменные и привязка к ним параметров; материал, плотность и
масса.
- **Измерение и обмен.** Габарит, объём, центр масс, грани и рёбра; экспорт и импорт STEP, экспорт
IGES и STL (с измеренным шагом сетки и честным уровнем проверки), выгрузка контура плоской детали
в DXF, снимок модели картинкой прямо в чат.

*Дашборд приёмки по профилю `mechanical-core-v1`, снимок 23.09.2026: каждый режим инструмента
подтверждается живым прогоном. Числа на картинке - состояние на дату снимка, и от действующих они
отстают; действующие числа - в [состоянии и планах](docs/project-status.md).*
Чего пока нет и что в работе: [состояние и планы](docs/project-status.md).
Текущий выпуск - **0.14.0**: 134 операции, 14 прямых инструментов, 23 профиля приёмки, режимов
**145/145** и зависимостей **82/82**, открытых нет. Заметки выпуска:
[distribution/v0.14.0.md](docs/distribution/v0.14.0.md).
## Почему ему можно доверять
Каждая операция возвращает измеренный уровень проверки и список того, что проверить не удалось.
Уровень не завышается: например, экспорт STL отвечает `structure_checked` и говорит, что точность
триангуляции ядру не передаётся, а локальный профиль сетки сервер не проверяет.
Повтор операции не применяет её дважды, устаревшие ссылки отвергаются, а не указывают на чужой
объект. Сервер пишет только в разрешённые каталоги, не выполняет произвольный код и пользуется
только документированным API КОМПАС. Подробно: [как устроено](docs/how-it-works.md).
## Документация
[Карта документации](docs/INDEX.md) · [инструменты](docs/TOOLS.md) ·
[состояние и планы](docs/project-status.md) · [как устроено](docs/how-it-works.md) ·
[обзор проекта](KOMPAS3D_MCP.md)
## Лицензия
[MIT](LICENSE-MIT) или [Apache-2.0](LICENSE-APACHE) на выбор получателя ([LICENSE](LICENSE)).
КОМПАС-3D является продуктом АСКОН и в репозиторий не входит; для работы нужна собственная лицензия.
<sub>ChatGPT, Codex и логотип OpenAI являются товарными знаками OpenAI; Claude и логотип Claude -
товарными знаками Anthropic. Проект не связан с OpenAI и Anthropic и не одобрен ими.</sub>
This server cannot be deployed
Maintenance
ActivityActive
ResponsivenessLimited data