Architecture Intelligence Platform — MCP-сервер для Claude Code
MCP-сервер сопоставляет описания API с трассировкой OpenTelemetry и передаёт агенту подтверждённый контекст архитектуры. Это помогает находить скрытые вызовы сервисов перед правкой кода.
Открыть на GitHubЧто делает Architecture Intelligence Platform
Сервер связывает статические контракты вроде AsyncAPI с реальным поведением микросервисов в рантайме. Вместо ручной сборки топологии ИИ-агент получает готовый срез зависимостей. Инструменты возвращают расхождения: вызовы, зафиксированные в телеметрии, но отсутствующие в схемах (OBSERVED_ONLY), либо объявленные эндпоинты, не проявившие себя в текущем окне наблюдения (NOT_OBSERVED_IN_WINDOW). Подтверждённые связи помечаются как CONFIRMED.
Все ответы привязаны к снимкам snapshot_id и содержат ссылки на конкретные доказательства. Через инструмент get_evidence агент проверяет первоисточник каждого утверждения — файл схемы или спан OpenTelemetry. Если потребителя очереди однозначно определить нельзя, AIP фиксирует ограничение в поле limitations, а не пытается угадать сервис.
Инструменты для агентов работают только на чтение. Для локального запуска демонстрации требуются Docker с Compose, а также утилиты curl и jq. Ключ к сторонним языковым моделям для этого контура не нужен.
Какие задачи решает
- выявить недокументированные вызовы сервисов по телеметрии
- проверить расхождения между AsyncAPI-контрактами и трафиком в рантайме
- подтвердить источник архитектурных связей через спаны OpenTelemetry
- передать агенту проверенный граф зависимостей перед рефакторингом
Примеры запросов агенту
- Проверь архитектурный дрейф для order-service через инструмент get_architecture_drift
- Запроси доказательства для найденной зависимости LegacyPricingService через get_evidence
- Покажи подтверждённые и необнаруженные зависимости сервиса rest-fights
Как установить Architecture Intelligence Platform
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Architecture Intelligence Platform
Как подключить Architecture Intelligence Platform к Claude Code?
Сервер зарегистрирован в реестре MCP под именем io.github.michaelegner/architecture-intelligence-platform. Локальное окружение с Neo4j и OTel Collector запускается через Docker с помощью скрипта examples/runtime-demo/mcp-demo.sh.
Что делает Architecture Intelligence Platform?
Сервер сопоставляет задекларированные API-контракты с фактическими трейсами OpenTelemetry и передаёт агенту проверенные архитектурные факты. Он чётко разделяет подтверждённые связи, скрытые зависимости и неактивные эндпоинты.
Нужен ли API-ключ LLM для работы сервера?
Нет, для запуска демо и формирования архитектурных снимков ключ языковых моделей не требуется. Система обрабатывает локальные файлы контрактов и спаны телеметрии без внешних вызовов ИИ.
