ai-architect-mcp-codebase — MCP-сервер для Claude Code
Индексирует репозиторий в локальный граф символов и связей, чтобы агент отвечал на структурные вопросы: кто вызывает функцию, что от неё зависит, какие символы затронул диф.
Открыть на GitHubЧто делает ai-architect-mcp-codebase
Сервер разбирает исходники через tree-sitter и складывает определения, вызовы, импорты и реализации в графовую базу LadybugDB на вашей машине. Дальше агент ходит по этому графу через MCP: ищет символы, смотрит вызывающих и вызываемых, строит обратные зависимости, прослеживает пути исполнения от точек входа, накладывает git-диф на изменённые символы и сравнивает два графа одного кода. Ответы приходят с местами в исходниках и оговоркой о том, насколько полон анализ.
Индексация и запросы идут локально, без сетевых вызовов, языковая модель код не читает. Файлы сервер не правит: граф и вспомогательные файлы ложатся в каталог output_dir, а снимок в репозитории появляется только по отдельному запросу. Выборка идёт статическим разбором, поэтому вызовы через рефлексию, динамическую диспетчеризацию, сгенерированный код и нераскрытые макросы в граф не попадают без языкового прохода (lsp: true) или трассировок (ingest_traces). Ruby разбирается поверхностно. Пустой ответ одинаково означает «связи нет» и «не проиндексировано» — различать их помогает отчёт о покрытии.
Сервер отдаёт один из двух наборов инструментов, выбранных при старте флагом --profile или переменной AP_PROFILE (флаг сильнее). Профиль core — 8 инструментов: health_check, analyze_codebase, search_codebase, get_context, get_symbol, get_impact, query_graph, detect_changes. Профиль full — все 27, с ручными проходами по графу, историей, трассировками, проверками и сборкой артефакта.
Какие задачи решает
- найти всех, кто вызывает функцию, перед её переименованием
- оценить, какие модули затронет правка в общем коде
- разобрать незнакомый репозиторий по точкам входа и потокам исполнения
- сопоставить git-диф с символами, которые он меняет
- сравнить структуру двух версий одного кода
Примеры запросов агенту
- Проиндексируй репозиторий в
/tmp/repo-graphи покажи отчёт о покрытии - Кто вызывает
src/main.rs::handle_tool_callи что от него зависит? - Какие символы затронул диф между
mainиHEAD?
Как установить ai-architect-mcp-codebase
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о ai-architect-mcp-codebase
Как установить ai-architect-mcp-codebase в Claude Code?
Как плагин: claude plugin marketplace add cdeust/ai-architect-mcp-codebase, затем claude plugin install ai-architect-mcp-codebase@ai-architect-mcp-codebase-marketplace. Плагин скачивает релизный бинарник и проверяет его происхождение через Sigstore, для этого нужен GitHub CLI 2.68 или новее.
Что делает ai-architect-mcp-codebase?
Строит локальный граф символов и их связей по исходникам репозитория и отдаёт его агенту через MCP. Агент может искать по графу, смотреть контекст символа, считать влияние правки и разбирать диф.
Почему в графе нет некоторых вызовов?
Разбор статический, поэтому рефлексия, динамическая диспетчеризация, сгенерированный код и нераскрытые макросы остаются без рёбер. Добавить их может языковой проход с lsp: true или загрузка трассировок.
