ADR Guard — MCP-сервер для Claude Code: что делает и как установить
Предоставляет ИИ-агентам доступ к поиску, валидации и анализу архитектурных решений (ADR). Помогает проверять структуру документов и выявлять архитектурный дрейф.
Открыть на GitHubЧто делает ADR Guard
Сервер открывает ассистенту доступ только для чтения к записям архитектурных решений (ADR). Инструмент проверяет обязательные разделы и связи между документами. При необходимости генератор строит Markdown-индекс docs/adr/README.md, но делает это строго после успешной валидации. Поддерживаются канонические шаблоны Minimal и Extended, а также внешний формат MADR 4.0.
Внутри заложена проверка архитектурного дрейфа и сопоставление записей с кодовой базой. Агент может формировать отчёты в форматах JSON и SARIF. Для работы потребуется среда .NET 10.0. Валидатор проверяет исключительно правила оформления, поэтому он не оценивает техническую целесообразность архитектуры.
Какие задачи решает
- проверять структуру и метаданные архитектурных решений
- находить архитектурный дрейф между кодом и документацией
- генерировать детерминированный Markdown-индекс файлов ADR
- сопоставлять архитектурные решения с кодовой базой проекта
Примеры запросов агенту
- Проверь валидность файлов в каталоге
docs/adrчерез ADR Guard. - Найди архитектурные решения, связанные с базой данных.
- Обнови индексный файл
docs/adr/README.mdдля текущих записей.
Как установить ADR Guard
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о ADR Guard
Как установить ADR Guard для Claude Code?
Для работы сервера требуется среда .NET 10.0. Сам MCP-сервер опубликован в NuGet под именем RodriOliveira.AdrGuard.Mcp, а глобальную утилиту CLI устанавливают командой dotnet tool install --global RodriOliveira.AdrGuard.
Что делает MCP-сервер ADR Guard?
Он предоставляет агенту инструменты только для чтения, чтобы находить, валидировать и анализировать архитектурные решения. Это помогает ИИ учитывать принятые проектные договорённости при изменении кода.
Оценивает ли ADR Guard техническое качество архитектуры?
Нет, инструмент контролирует исключительно детерминированные правила оформления: наличие разделов, статусов и ссылок. Оценка целесообразности инженерных решений остаётся задачей разработчиков.
