Нейросети научились писать код, но до недавнего времени оставались беспомощными в реальном мире софта. Протокол MCP (Model Context Protocol) убрал эту стену, дав моделям прямой доступ к инструментам. И если для веба коннекторы появились сразу, то инженерный софт незаслуженно забыли. Я решил это исправить и дал нейросети прямой доступ к API КОМПАС-3D.

Что умеет сервер

Сервер работает как мост между MCP-клиентом (Codex, Cursor, любой другой хост, поддерживающий протокол) и запущенным экземпляром КОМПАС-3D. Обмен идёт через стандартный ввод-вывод, сервер переводит их в COM-вызовы и возвращает результат.(На вход можно отправлять как текст, так и картинку-образец, если нейросеть поддерживает).

Набор инструментов охватывает основные задачи 2D-черчения. Создание геометрии: отрезки, полилинии, бесконечные прямые, окружности, дуги (по радиусу и по трём точкам), точки, прямоугольники, правильные многоугольники, эллипсы и их дуги. Редактирование: фаски, скругления, усечение кривых, перемещение, трансформация (масштаб, поворот), симметрия, удаление, изменение параметров существующих объектов. Анализ и измерения: расстояние, длина кривой, угол, площадь, поиск пересечений. Работа с документом: создание и открытие файлов, сохранение, переключение видов и слоёв, скриншот рабочей области, экспорт геометрии в JSON.

Отдельный инструмент execute_python_script позволяет выполнять произвольный Python-код прямо в контексте КОМПАС. В глобальную область видимости скрипта инжектируются готовые объекты: kompas (корневой KompasObject API5), app7 (IApplication API7), doc2d (активный документ), tools (доступ ко всем зарегистрированным инструментам как к обычным функциям). Есть высокоуровневые обёртки: ln(x1, y1, x2, y2) для быстрого рисования линии, circle(x, y, r) для окружности, rect(x, y, w, h) для прямоугольника. Можно писать сложные скрипты, не выходя из диалога с моделью.

Подключение к КОМПАС

Если КОМПАС не запущен, COM-механизм попытается запустить его. Если не получится, вернёт ошибку. При выполнении команд сервер проверяет наличие активного 2D-документа.

Конфигурация

Достаточно указать путь к скрипту в конфиге MCP-клиента. Вот как это будет выглядеть в релизной версии:

Пример конфигурации для Claude Code, Roo Code в файле mcp.json:

{
"mcpServers": {
"kompas-3d": {
"command": "python",
"args": ["C:/Path/To/MCP-KOMPAS-3D/main.py"],
"env": {
"SERVER__LOG_LEVEL": "DEBUG"
}
}
}
}

Пример конфигурации для Codex в файле config.toml:

[mcp_servers.kompas-3d]
command = "python"
args = ["C:/Path/To/MCP-KOMPAS-3D/main.py"]
# указывайте ваш путь в args

Как это работает в реальной сессии

Пользователь пишет AI-ассистенту: "Нарисуй прямоугольник 100x50 со скруглёнными углами радиусом 5". Модель разбивает задачу на шаги: создать прямоугольник, затем применить скругление к каждому углу. Для каждого шага она вызывает соответствующий инструмент через MCP.

Запрос create_rectangle с параметрами x1=0, y1=0, x2=100, y2=50 попадает на сервер. Обработчик находит зарегистрированный RectangleTool, формирует замыкание, передаёт его в ComWorker. Рабочий поток вызывает ksRectangle через API5. Результат (reference созданного объекта) возвращается модели. Она использует его для следующего вызова create_fillet с радиусом 5.

Если что-то идёт не так (документ не открыт, КОМПАС завис, COM-соединение оборвалось), сервер возвращает структурированную ошибку с описанием проблемы и рекомендациями. Модель может попробовать переподключиться через reconnect() или создать новый документ.

Ограничения и открытые вопросы

Сервер работает только с 2D-документами: чертежами и фрагментами.

Некоторые операции через API ведут себя нестабильно. Создание видов и слоёв через API7 иногда отказывается работать, приходится использовать API5.

Производительность зависит от сложности документа. На чертеже с тысячами объектов итерация по геометрии занимает секунды. Для критичных сценариев есть batch_execute, который группирует несколько операций в один вызов.

Если вас заинтересовал мой проект и вам действительно это может помочь, то смело предлагайте свои идеи для улучшения его функционала. Пишите чтобы вы добавили, а я в свою очередь, увидев ваш актив, выкачу рабочую тестовую версию программы с вашими идеями по возможности реализации.

Также связаться со мной можно по почте: grandfatherofny1984@gmail.com

Интересная гибкая линейка, которая не ломается. Стоит линейка длиной 20 см - 157 руб. Ссылка на неё

2) Линейка для геометрии

Интересная линейка для черчения различных геометрических фигур. Стоит такая 349 руб. Ссылка на неё

Ластик (стиралка) в форме карандаша. Стоит 113 руб. Ссылка на него

Держатель страниц книги на палец. Стоит такой 104 рубля. Ссылка на него

Набор из 1000+ деталей для сборки различных молекулярных форм. Стоит такой около 2 000 руб. Ссылка на него

Корректирующая лента 50 метров. Стоит такая 259 руб. Ссылка на неё

сПеналы для ручек и карандашей в стиле ретро. Стоит на выбор около 350 руб. Ссылка на них

Автоматическая точилка для карандашей. Стоит такая около 370 руб. Ссылка на неё

Миниатюрный калькулятор. Стоит такой 76 руб. Ссылка на него

Мягкий держатель ручки и карандаша. Стоит 3 штуки 123 руб. Ссылка на набор

Ящичек для канцелярских принадлежностей. Стоит такой 167 руб. Ссылка на него

Треугольные линейки 15 см. Стоит штука 77 руб. Ссылка на них

Генератор случайных математических задач. Стоит на выбор около 400 руб. Ссылка на них

Пеналы для письменных принадлежностей переливающиеся. Стоит штука 129 руб. Ссылка на них

Большие пеналы для учёбы. Стоит штука 359 руб. ссылка на них

Металлическая палитра для рисования. Стоит такая 157 руб. Ссылка на неё

Водонепроницаемый рюкзак Heroic Knight с рулонным верхом. Стоит такой 2 256 руб. Ссылка на него

Набор тонких кисточек для рисования. Стоит 10 штук 90 руб. Ссылка на него

Сумка для сменной обуви 43X 32 см. Стоит 140 руб. ссылка на неё

Ручка с большой емкостью чернил и тонким наконечником . Стоит штука 59 руб. Ссылка на них

Записная книжка в винтажном стиле. Стоит такая 359 руб. Ссылка на неё

Набор карандашей. Стоит 10 штук 127 руб. Ссылка на них

Карандаши с радужным сердечником. Стоит 12 штук 339 руб. Ссылка на них

Контейнер для бутерброда. Стоит такой 249 руб. Ссылка на него

Контейнер для еды (обеда). Стоит такой 765 руб. Ссылка на него