Codebase Context MCP
Codebase Context дает агенту карту репозитория, ранжированный поиск по коду, ссылки на символы и память проекта через MCP и CLI
- 68 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- Индексирует код локально и пишет данные в папку .codebase-context проекта
- Возвращаемые клиентом фрагменты кода могут уйти поставщику его модели
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/codebase-contextОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Индексирует код локально и пишет данные в папку .codebase-context проекта
- Возвращаемые клиентом фрагменты кода могут уйти поставщику его модели
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Codebase Context локально индексирует репозиторий, чтобы агент осмотрел его до правки. Через MCP и CLI доступны карта репозитория со структурой, замеченными паттернами и примерами файлов, ранжированный поиск с источниками и оценкой качества совпадения, ссылки на символы и связи файлов. Ссылки на символы показывают статические вхождения идентификаторов, это не граф вызовов во время работы. Связи импортов и реэкспортов построены для TypeScript и JavaScript, для Python и Go навигации по импортам нет. Отдельные анализаторы есть для Angular, React, Next.js и NestJS. Инструменты `remember` и get_memory хранят и отдают соглашения, решения и неудачи проекта. Файл памяти можно коммитить, а индекс лучше исключить из git. Команда codebase-context-review собирает ограниченный пакет из закоммиченного диффа, но сама код не ревьюит. Новые индексы бета-версии работают по ключевым словам без загрузки моделей эмбеддингов, семантический режим включается явно и требует LanceDB. Клиент запускает сервер по stdio, мастер init прописывает регистрации для Claude Code, Codex, Cursor и OpenCode. На 4 ноября 2026 года npm beta указывает на 2.3.1-beta.0, а latest остается 2.2.0.
Для кого. Разработчикам, чьи агенты в Claude Code, Codex, Cursor или OpenCode правят большие репозитории и сначала должны найти нужные файлы и соглашения.
Подходит, если
- В незнакомом репозитории надо найти, где реализована функция, прежде чем что-то менять
- Нужно увидеть структуру, паттерны и примеры файлов до сужения задачи
- Агенту требуются ссылки на символ и связи импортов в проекте на TypeScript
- Соглашения и причины решений команды стоит хранить в memory.json рядом с кодом
- Для ревью нужен ограниченный пакет контекста из закоммиченного диффа
Не подходит, если
- Нужен граф вызовов во время выполнения: ссылки на символы здесь статические
- Проект на Python или Go и нужны связи импортов: навигация по ним не поддерживается
- Нельзя ставить Node.js 22 или новее: бета требует его
- Нужен автоматический ревьюер кода: codebase-context-review только собирает контекст
Пример запроса к агенту
Используй Codebase Context, найди, где в проекте реализован экспорт отчетов, и открой нужные файлыMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
- Бета 2.3.1-beta.0 требует Node.js 22 или новее. Явный выбор беты: npx -y codebase-context@2.3.1-beta.0, а безымянный npx -y codebase-context может взять 2.2.0.
- Семантическое индексирование включается явно и требует LanceDB, модели локального провайдера скачиваются отдельно.
- Низкая уверенность поиска означает слабое совпадение, реализация при этом может существовать, поэтому найденный код стоит открыть и прочитать.
- Анализаторы для Angular, React, Next.js и NestJS отдельные, остальные файлы идут через общий анализатор.
- Клиент ИИ может передавать возвращенный код своему поставщику модели, сервер этим не управляет.
Как отключить. Уберите запись codebase-context из конфигурации клиента, для Claude Code это команда claude mcp remove codebase-context. Индекс лежит в папке .codebase-context проекта, удалите ее вручную.
Частые вопросы
Как подключить Codebase Context к Claude Code?
Выполните claude mcp add --scope user --transport stdio codebase-context -- npx -y codebase-context. Для бета-версии укажите codebase-context@2.3.1-beta.0. Мастер init сам пропишет проектные регистрации для Claude Code, Codex, Cursor и OpenCode.
Нужны ли GPU или API-ключ?
Нет. Индекс по ключевым словам строится локально без Docker, GPU и ключа API. Если вручную подключить удаленного провайдера эмбеддингов, фрагменты кода уйдут к нему.
Что такое project memory?
Инструменты `remember` и get_memory сохраняют и возвращают соглашения, решения, ловушки и неудачи. Чтобы делиться памятью, но не индексом, добавьте в .gitignore строки .codebase-context/* и !.codebase-context/memory.json.
Чем ссылки на символы отличаются от графа вызовов?
Это статические вхождения идентификатора в коде. Граф вызовов во время выполнения инструмент не строит.
Как запустить поиск из терминала?
Из репозитория выполните node /path/to/codebase-context/dist/index.js search --query "функция или символ" --limit 5. Команда map строит карту, status показывает состояние, reindex обновляет индекс.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер, который превращает большую кодовую базу в семантический граф функций для точной навигации и поиска по смыслу
Локальный семантический индекс кода: агент ищет по смыслу, затем идет к определениям, вызовам и путям зависимостей
Локальный MCP-сервер индексирует код проекта, и агент достает из индекса нужные функции вместо чтения целых файлов
CLI и MCP-сервер семантического поиска по коду на векторах: Ollama для локальных эмбеддингов, граф вызовов и обзор файлов
Дает агенту разбираться в вашем репозитории: индексирует код и отвечает на вопросы о нем в Claude Code, Cursor, Codex, Windsurf и других
Один MCP-сервер дает агенту карту кода на более 300 языков, историю git, общую память и поиск по документам с OCR.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Codebase Context (эта карточка) | нет | не нужна | 68 | |
| Serena | нет | не нужна | 31 335 | Serena опирается на языковые серверы для символьной навигации, а Codebase Context строит локальный индекс с картой репозитория и памятью проекта |
| Code Context Engine | нет | не нужна | 457 | отдельный движок контекста для кода, а Codebase Context добавляет карту паттернов, память проекта и пакет контекста для ревью |
Коротко о README
README начинается с версий: бета 2.3.1-beta.0 и стабильная 2.2.0 на 4 ноября 2026. Затем описаны запуск из терминала командами map, search, status и reindex, настройка клиентов через init, возможности агента, приватность хранения и ограничения доказательной базы с отчетом о бенчмарках.