Kompas3D MCP

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

Подключите сервер к ИИ-агенту (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, сверит контрольную сумму, создаст конфигурацию и подключит сервер. Разрешите ему скачивание и запуск установщика, когда он спросит.

  ChatGPT Codex

https://github.com/SergeySklyarov/Kompas3D-MCP
Установи и подключи последнюю принятую версию KompasMCP из этого репозитория на этой Windows-машине по инструкции docs/operator-guide/codex-setup.md; проверь зависимости, checksum и доступность инструментов; мои модели не изменяй.

  Claude Code

https://github.com/SergeySklyarov/Kompas3D-MCP
Установи и подключи последнюю принятую версию KompasMCP из этого репозитория на этой Windows-машине по инструкции docs/operator-guide/claude-setup.md; проверь зависимости, checksum и доступность инструментов; мои модели не изменяй.

После установки перезапустите клиент и в новом чате попросите «вызови kompas_health и kompas_capabilities»: сервер ответит версией и списком инструментов. Подробно: Codex, Claude, другой MCP-клиент и ручная установка, сборка из исходников.

Пример: деталь по чертежу, собранная агентом

Агенту дают чертёж и задачу, и он строит деталь сам, вызовами инструментов этого сервера. Каждый шаг сервер подтверждает измерением.

Слева чертёж задания конкурса 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: каждый режим инструмента подтверждается живым прогоном. Числа на картинке - состояние на дату снимка, и от действующих они отстают; действующие числа - в состоянии и планах.

Чего пока нет и что в работе: состояние и планы.

Текущий выпуск - 0.14.0: 134 операции, 14 прямых инструментов, 23 профиля приёмки, режимов 145/145 и зависимостей 82/82, открытых нет. Заметки выпуска: distribution/v0.14.0.md.

Почему ему можно доверять

Каждая операция возвращает измеренный уровень проверки и список того, что проверить не удалось. Уровень не завышается: например, экспорт STL отвечает structure_checked и говорит, что точность триангуляции ядру не передаётся, а локальный профиль сетки сервер не проверяет. Повтор операции не применяет её дважды, устаревшие ссылки отвергаются, а не указывают на чужой объект. Сервер пишет только в разрешённые каталоги, не выполняет произвольный код и пользуется только документированным API КОМПАС. Подробно: как устроено.

Документация

Карта документации · инструменты · состояние и планы · как устроено · обзор проекта

Лицензия

MIT или Apache-2.0 на выбор получателя (LICENSE). КОМПАС-3D является продуктом АСКОН и в репозиторий не входит; для работы нужна собственная лицензия.

_{ChatGPT, Codex и логотип OpenAI являются товарными знаками OpenAI; Claude и логотип Claude - товарными знаками Anthropic. Проект не связан с OpenAI и Anthropic и не одобрен ими.}