codeindex

AIコーディングエージェント向けに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

なぜ

AIコーディングエージェントは、ファイル全体を読むためにトークンを消費します。codeindexは、シンボルの概要、定義、呼び出し元、影響範囲、依存関係チェーンといった構造的な質問に、数千トークンではなく数百トークンで答えます。

plan_changeを1回呼び出すだけで、シンボルが定義されている場所、すべての呼び出し箇所、ファイルのアーキテクチャ上の役割（神モジュール / 安定コア / アイランド / ドライバー）、確認すべきハードコードされたリテラル、ファイルが変更された場合の完全な推移的影響範囲が返ります。

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

AIエージェントに登録してください:

# 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ツール）

対応言語

tree-sitter経由で40以上の言語に対応: Rust、Python、TypeScript/TSX、Go、Zig、C、C++、Java、Ruby、Bash、C#、Kotlin、Lua、Scala、Elixir、R、Swift、Dart、Haskeel、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を指定してください。

アーキテクチャ

• Parser: 40以上の文法を持つtree-sitterで、単一バイナリにコンパイルされます

• インデックス: あいまいテキスト検索用のトライグラムインデックス + 完全一致の識別子検索用の転置ワードインデックス

• 依存関係グラフ: 順方向と逆方向のエッジを持つファイルレベルのインポート解決

• バージョンストア: 増分更新のためのシーケンス番号でファイル変更を追跡

• ライブウォッチャー: ファイルの作成/変更/削除時に再インデックス化（MCPモードではバックグラウンドスレッド）。Linuxではinotify、macOSとWindowsではポーリング方式の走査で、数秒ごとにmtimeとサイズを比較します。statusはどちらのバックエンドが稼働中かをwatcher_backendとして報告します。

• スナップショット: 完全なインデックスを.codeindex.jsonに永続化し、再起動時には再インデックス化ではなくスナップショットを読み込みます

• MCPサーバ: stdio上のJSON-RPCで、MCP 2024-11-05プロトコルを実装

プラットフォームサポート

注記がある場合を除き、各行はCIでビルドされ、そのプラットフォーム上でテストが実行されます。statusが稼働中のウォッチャーバックエンドを報告するため、推測する必要はありません。

Windowsでは、install.shとプラグインのランチャーはシェルスクリプトであるため、Git Bash、MSYS2、またはCygwinが必要です — スクリプトはシェルを検出して、正しい.exeアセットを解決します。プラグインはそのランチャーを通じてサーバーを登録するため、シェルのないネイティブWindows版Claude Codeはバイナリを直接登録する必要があります:

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に結果を送りますが、リンクされているtree-sitterのCソースがデバッグ用のprintfパスを通じてこれを破損させます。テストバイナリをビルドして直接実行するのは、そのプロトコルが邪魔をしない同じテストです。

他ツールとの比較

chat-recallと組み合わせて使用

codeindexは、目の前にあるコードについての質問に答えます。**chat-recall**は、あなたがすでに行った作業についての質問に答えます — Claude Code、Gemini CLI、Codex、OpenCode、Antigravityのセッションを1つの検索可能な履歴にインデックス化し、それをMCPでも公開します。

この2つは、エージェントが忘れることの両方をカバーします: codeindexは、概要点化できたはずのファイルを読み直すのを防ぎ、chat-recallは、すでに完了した作業をやり直すのを防ぎます。chat-recallはPATH上のcodeindexバイナリを検出し、見つけた場合は追加のコードインテリジェンスツールを4つ登録します — どちらも相手を必要としません。

ライセンス

MIT。 LICENSEを参照。