archsteer — MCP-сервер для Claude Code
archsteer строит модель архитектуры из кода, проверяет файлы и подсказывает агенту целевые паттерны. Подходит для контроля дрейфа правил.
claude mcp add archsteer -- uvx archsteerЧто делает archsteer
archsteer собирает архитектурную модель проекта в .archsteer/model.json. MCP-сервер даёт агенту инструменты current_architecture, get_target_pattern и check_file: можно посмотреть текущее устройство проекта, получить целевой паттерн и проверить конкретный файл. Работа с репозиторием выполняется локально; до первого сканирования не нужны аккаунт, API-ключ или конфигурация.
CLI умеет создавать каркас .archsteer/, строить модель, обновлять документацию и ADR, считать нарушения по правилам, принимать текущий долг как baseline и запускать проверку для CI или pre-commit. Поддерживаются JavaScript / TypeScript, Python, Java и Salesforce Apex; есть распознавание Next.js App Router, Spring и Apex-конвенций. Без доступного uvx MCP-команда из способа установки не запустит сервер.
Сервер можно подключить к Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed и Gemini CLI. Для Claude Code доступны команды claude mcp add archsteer -- uvx archsteer; отдельный CLI ставится через pip install archsteer.
Какие задачи решает
- построить карту зависимостей проекта из исходного кода
- проверить файл на архитектурные нарушения
- сформировать живую документацию и ADR
- зафиксировать текущий долг и блокировать новые нарушения
- подсказать агенту целевой паттерн для изменяемых файлов
Примеры запросов агенту
- Покажи текущую архитектуру проекта и основные границы слоёв.
- Проверь
src/controllers/payment.jsи объясни нарушения правил. - Подскажи целевой паттерн для добавления нового сервиса в этот проект.
Как установить archsteer
Командой платформы
claude mcp add archsteer -- uvx archsteeruvx запускает команду с именем пакета; если в README она другая — uvx --from archsteer <команда>
Командой платформы
codex mcp add archsteer -- uvx archsteeruvx запускает команду с именем пакета; если в README она другая — uvx --from archsteer <команда>
Файл настроек
{
"mcpServers": {
"archsteer": {
"command": "uvx",
"args": [
"archsteer"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from archsteer <команда>
Файл настроек
{
"servers": {
"archsteer": {
"type": "stdio",
"command": "uvx",
"args": [
"archsteer"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from archsteer <команда>
Командой платформы
gemini mcp add archsteer uvx archsteeruvx запускает команду с именем пакета; если в README она другая — uvx --from archsteer <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о archsteer
Как установить archsteer в Claude Code?
Выполните claude mcp add archsteer -- uvx archsteer. Команда добавит MCP-сервер archsteer в Claude Code.
Что делает archsteer?
Он выводит архитектурную модель из кода, проверяет файлы по правилам и возвращает агенту сведения о текущей архитектуре и целевых паттернах. Результат хранится в .archsteer/model.json.
Какие языки поддерживает archsteer?
Поддерживаются JavaScript / TypeScript, Python, Java и Salesforce Apex. Для Next.js App Router, Spring и Apex используются специальные сигналы и соглашения.
