open-codebase-index MCP
Локальный семантический индекс кода: агент ищет по смыслу, затем идет к определениям, вызовам и путям зависимостей
- 230 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Читает исходники проекта и строит индекс на диске, куски кода уходят внешнему провайдеру эмбеддингов, если выбран OpenAI или Google
- Следит за файлами и пересобирает индекс при изменениях, плагин для Claude Code ставит MCP-сервер через npx
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/open-codebase-indexОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает исходники проекта и строит индекс на диске, куски кода уходят внешнему провайдеру эмбеддингов, если выбран OpenAI или Google
- Следит за файлами и пересобирает индекс при изменениях, плагин для Claude Code ставит MCP-сервер через npx
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
open-codebase-index строит локальный индекс репозитория и отдает его агенту как набор инструментов. Файлы разбираются через tree-sitter, куски кода получают эмбеддинги, а поиск соединяет векторный и ключевой подход BM25. Метаданные лежат в SQLite, векторы в usearch, и все хранится рядом с проектом: для OpenCode это `.opencode/`, для Claude Code `.claude/`, для Codex и Pi `.codebase-index/`. Инструменты рассчитаны на экономный расход токенов. `codebase_context` собирает компактный пакет доказательств по вопросу, `codebase_peek` показывает файлы и символы без тел, `codebase_search` отдает код целиком, `implementation_lookup` находит определение. Вызовы и пути между символами показывают `call_graph` и `call_graph_path`, `find_similar` ищет аналоги, `pr_impact` оценивает влияние ветки или текущих правок. Индекс инкрементальный и учитывает ветки Git. Эмбеддинги берутся у Ollama, OpenAI, Google или из совместимой конечной точки, при режиме `auto` провайдеры пробуются в таком порядке. Хосты подключаются по-разному: нативный плагин OpenCode, плагин из маркетплейса для Claude Code и Codex со скиллом `codebase-search`, пакет для Pi и MCP-сервер `open-codebase-index-mcp` для Cursor, Windsurf и остальных. Для терминала есть команда `ocbi`.
Для кого. Разработчикам больших репозиториев, где агент тратит токены на чтение лишних файлов, и тем, кто хочет искать код по смыслу, не отправляя исходники в облачный индекс.
Подходит, если
- Агент не знает имени функции и ищет, где проверяется состояние авторизации перед запросом к API
- Нужно найти все вызовы метода и путь от одного символа до другого через `call_graph_path`
- Перед правкой хочется оценить влияние ветки или незакоммиченных изменений инструментом `pr_impact`
- Проект большой, и компактный `codebase_context` заменит десяток открытых агентом файлов
- Вы работаете в OpenCode, Claude Code, Codex, Pi или Cursor и хотите один индекс для всех
Не подходит, если
- Репозиторий маленький и агенту хватает обычного поиска по тексту
- Нет ни локального Ollama, ни ключа провайдера эмбеддингов: индекс без них не построить
- Нужен поиск по точной строке: для литералов советуют обычные чтение и `grep`
Пример запроса к агенту
Проиндексируй этот репозиторий и найди, где перед запросом к API проверяется состояние авторизации, потом покажи вызывающие функцииMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
- Для первого индекса нужны эмбеддинги от Ollama, OpenAI, Google или совместимой конечной точки. При внешнем провайдере куски кода уходят к нему.
- Нужен Node.js 22.22 или новее, рекомендован 24 LTS.
- Старые пакеты `opencode-codebase-index` и `opencode-codebase-index-mcp` остаются алиасами, новые установки ставят `open-codebase-index`.
- Ссылки на тесты в `codebase_edit_context` берутся из исходников и не доказывают реальное покрытие.
Как отключить. Для OpenCode уберите `open-codebase-index` из списка плагинов в `opencode.json`. В Claude Code удалите плагин командой `/plugin`, в других клиентах уберите запись MCP-сервера. Индекс удаляется вместе с папками `.opencode/`, `.claude/index/` или `.codebase-index/` в проекте.
Частые вопросы
Как подключить open-codebase-index к Claude Code?
В Claude Code добавьте маркетплейс командой `/plugin marketplace add Helweg/open-codebase-index` и поставьте `/plugin install codebase-index@helweg-plugins`. Плагин приносит MCP-настройки и скилл `codebase-search`. Затем откройте новую сессию в нужной папке.
Чем open-codebase-index отличается от claude-context?
claude-context держит индекс в векторной базе и отдает агенту нужные фрагменты. open-codebase-index хранит все локально в SQLite и usearch, учитывает ветки и добавляет граф вызовов, поиск пути между символами и оценку влияния ветки.
Какой инструмент выбрать для поиска?
Для первого взгляда на незнакомый код `codebase_context` с `tokenBudget: 600` и `limit: 5`, для списка файлов `codebase_peek`, для кода целиком `codebase_search`, для точного определения `implementation_lookup`.
Нужен ли для работы интернет?
Для хранения нет, индекс локальный. Интернет нужен, если эмбеддинги берутся у OpenAI или Google. С Ollama и моделью вроде `nomic-embed-text` все остается на машине.
Какие языки разбирает индекс?
Нативный разбор есть для TypeScript, JavaScript, Python, Rust, Swift, Go, Kotlin, Java, C#, Ruby, C/C++, PHP, Bash, Zig и других языков. Остальные форматы индексируются как обычный текст.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальный индекс кодовой базы для агентов: гибридный поиск, графы зависимостей и анализ последствий изменений
MCP-сервер и CLI на Rust: граф вызовов и гибридный семантический поиск по коду для Claude Code и Codex
MCP-сервер индексирует локальный репозиторий через tree-sitter и дает агенту поиск по коду, список файлов и сводку по структуре файла
Локальный MCP-сервер индексирует код проекта, и агент достает из индекса нужные функции вместо чтения целых файлов
Локальный MCP-сервер и CLI для агентов: семантический поиск по коду, графы вызовов и анализ влияния изменений
MCP-сервер, который превращает большую кодовую базу в семантический граф функций для точной навигации и поиска по смыслу
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| open-codebase-index (эта карточка) | нет | не нужна | 230 | |
| Claude Context | да | API-ключ | 12 673 | держит индекс проекта в векторной базе и отдает агенту нужные фрагменты |
| Serena | нет | не нужна | 31 148 | дает агенту возможности IDE: поиск символов, правку и переименование |
Коротко о README
README начинается с описания локального семантического индекса и установки пакета с командой `ocbi`. Затем идут сильные стороны (гибридный поиск, экономия токенов, инкрементальная индексация, парсинг десятков языков), быстрый старт для OpenCode и таблица хостов. Дальше описаны рекомендуемый порядок работы, выбор инструмента поиска, схема индексации, провайдеры эмбеддингов и пример конфигурации.