codeindex

Движок структурного анализа кода, работающий как MCP-сервер для ИИ-агентов программирования.

Он индексирует вашу кодовую базу с помощью tree-sitter (40+ языков), строит триграммный полнотекстовый индекс, инвертированный индекс слов и граф зависимостей — и предоставляет их через 16 MCP-инструментов.

 ┌─────────────┐      MCP (stdio)       ┌──────────────┐
 │  AI Agent   │ ◄─────────────────────► │   codeindex  │
 │ (Claude,    │   16 tools, JSON-RPC    │  (Zig binary) │
 │  Cursor…)   │                         │              │
 └─────────────┘                         └──────┬───────┘
                                                │
                                   tree-sitter parse (40+ langs)
                                         trigram + word index
                                         dependency graph
                                         snapshot persistence

Зачем

ИИ-агенты программирования тратят токены на чтение целых файлов. codeindex отвечает на структурные вопросы — описания символов, определения, вызывающий код, радиус поражения, цепочки зависимостей — за несколько сотен токенов вместо тысяч.

Один вызов plan_change возвращает: где определён символ, все места вызовов, архитектурную роль файла (божественный модуль / стабильное ядро / остров / драйвер), жёстко заданные литералы, которые стоит проверить, и полный транзитивный радиус поражения, если файл изменится.

Related MCP server: OpenCodeHub MCP Server

Быстрый старт

# Install (prebuilt binary or build from source)
curl -fsSL https://raw.githubusercontent.com/munhq/codeindex/main/install.sh | bash

# Or build manually:
cd zig && ./fetch-vendor.sh && zig build -Doptimize=ReleaseFast

Зарегистрируйте в вашем ИИ-агенте:

# Claude Code — the plugin is the one-step path. It ships the skill, the hook
# and the MCP server together, and its launcher finds or fetches the binary.
claude plugin marketplace add munhq/codeindex
claude plugin install codeindex@codeindex

# Without the plugin (or for a different MCP client), register the binary
# directly. Do not do both: two registrations mean two servers, two copies of
# every tool schema, and two writers on one snapshot. install.sh detects the
# plugin and skips this step when it is present.
claude mcp add -s user codeindex -- ~/.local/bin/codeindex --mcp

# Cursor / other MCP clients: add to your config
{
  "mcpServers": {
    "codeindex": {
      "command": "~/.local/bin/codeindex",
      "args": ["--mcp"]
    }
  }
}

При следующем запуске агента codeindex проиндексирует ваш проект в фоновом режиме и будет обслуживать структурные запросы.

MCP-инструменты

Анализы (инструмент analyze)

Поддерживаемые языки

40+ языков через tree-sitter: Rust, Python, TypeScript/TSX, Go, Zig, C, C++, Java, Ruby, Bash, C#, Kotlin, Lua, Scala, Elixir, R, Swift, Dart, Haskell, TOML, JSON, YAML, HTML, CSS, SCSS, SQL, HCL, Dockerfile, Markdown, Nix, Make и другие.

Конфигурация

codeindex --mcp                          # Run as MCP server (stdio)
codeindex --workspace ./my-project       # Index a specific directory
codeindex --project-id my-project        # Project identifier
codeindex -v                             # Print version
codeindex -h                             # Print help

# Environment variables
CODEINDEX_WORKSPACE=/path/to/project     # Same as --workspace
CODEINDEX_PROJECT_ID=my-project          # Same as --project-id

codeindex автоматически определяет корень проекта, поднимаясь от рабочего каталога в поисках .git, package.json, Cargo.toml, go.mod, build.zig, pyproject.toml и т. д.

Он отказывается индексировать весь ваш домашний каталог или корень файловой системы — передайте --workspace, чтобы указать явно.

Архитектура

• Парсер: tree-sitter с 40+ грамматиками, компилируемый в единый бинарный файл

• Индекс: триграммный индекс для нечёткого текстового поиска + инвертированный индекс слов для точного поиска идентификаторов

• Граф зависимостей: разрешение импортов на уровне файлов с прямыми и обратными рёбрами

• Хранилище версий: отслеживает изменения файлов с порядковыми номерами для инкрементальных обновлений

• Живой наблюдатель: переиндексирует при создании/изменении/удалении файла (фоновый поток в MCP-режиме). inotify на Linux; опрос на macOS и Windows, который каждые несколько секунд сравнивает mtime и размер. status сообщает, какой бэкенд активен, в поле watcher_backend.

• Снимок: сохраняет полный индекс в .codeindex.json, так что при перезапуске загружается снимок вместо повторной индексации

• MCP-сервер: JSON-RPC через stdio, реализует протокол MCP 2024-11-05

Поддержка платформ

Каждая строка собирается в CI, и её тесты выполняются на этой платформе, если не указано иное. status сообщает активный бэкенд наблюдателя, так что это никогда не приходится угадывать.

В Windows install.sh и лаунчер плагина являются shell-скриптами, поэтому им нужны Git Bash, MSYS2 или Cygwin — скрипты сами распознают окружение и находят нужный .exe-артефакт. Плагин регистрирует свой сервер через этот лаунчер, поэтому нативному Windows Claude Code без shell следует зарегистрировать бинарный файл напрямую:

claude mcp add -s user codeindex -- C:\path\to\codeindex.exe --mcp

Ничего здесь не подписано и не нотаризовано. В macOS бинарный файл, полученный через curl, запускается без запроса Gatekeeper; файл, загруженный через браузер, помечается карантином, и xattr -d com.apple.quarantine codeindex снимает его.

Сборка из исходников

Требуется Zig 0.16.0.

cd zig
./fetch-vendor.sh    # Clone tree-sitter + 40 grammar repos
zig build -Doptimize=ReleaseFast
# Binary: zig/zig-out/bin/codeindex

Запуск тестов:

cd zig && zig build test-bin && ./zig-out/bin/test

zig build test передаёт результаты через IPC-протокол сборщика в stdout, который подключённые C-исходники tree-sitter портят своими отладочными выводами printf. Сборка тестового бинарного файла и его прямой запуск — это те же тесты, но без этого протокола на пути.

Сравнение с аналогами

Работает в паре с chat-recall

codeindex отвечает на вопросы о коде перед вами. chat-recall отвечает на вопросы о работе, которую вы уже сделали, — он индексирует ваши сессии Claude Code, Gemini CLI, Codex, OpenCode и Antigravity в одну доступную для поиска историю и тоже предоставляет её через MCP.

Вместе они покрывают обе половины того, что агент забывает: codeindex не даёт ему перечитывать файлы, которые можно было бы описать структурно, а chat-recall не даёт переделывать уже законченную работу. chat-recall обнаруживает бинарный файл codeindex в вашем PATH и при обнаружении регистрирует четыре дополнительных инструмента анализа кода — ни один из них не требует другого.

Лицензия

MIT. См. LICENSE.