# ai-architect-mcp-codebase

Индексирует репозиторий в локальный граф символов и связей, чтобы агент отвечал на структурные вопросы: кто вызывает функцию, что от неё зависит, какие символы затронул диф.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 7
- Автор: cdeust
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/cdeust/ai-architect-mcp-codebase
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/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, с ручными проходами по графу, историей, трассировками, проверками и сборкой артефакта.

## Требования
- Нужно: готовый бинарник из релизов репозитория

## Установка

### Claude Code (родная платформа)

**Установка**
- Команды запуска нет в реестре MCP — смотрите README репозитория

## Когда брать
- найти всех, кто вызывает функцию, перед её переименованием
- оценить, какие модули затронет правка в общем коде
- разобрать незнакомый репозиторий по точкам входа и потокам исполнения
- сопоставить git-диф с символами, которые он меняет
- сравнить структуру двух версий одного кода

## Примеры запросов агенту
- Проиндексируй репозиторий в `/tmp/repo-graph` и покажи отчёт о покрытии
- Кто вызывает `src/main.rs::handle_tool_call` и что от него зависит?
- Какие символы затронул диф между `main` и `HEAD`?

## Похожие
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47577
- [codegraph](https://affpapa.org/nevibecode/mcp/codegraph.md) — MCP-сервер · ★ 132
- [rpg-encoder](https://affpapa.org/nevibecode/mcp/rpg-encoder.md) — MCP-сервер · ★ 31
- [gitnexus-pdg-query](https://affpapa.org/nevibecode/skills/gitnexus-pdg-query.md) — скилл · 323 установки
- [vex](https://affpapa.org/nevibecode/mcp/vex.md) — MCP-сервер · ★ 12
- [trailmark](https://affpapa.org/nevibecode/skills/trailmark.md) — скилл · 4000 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md