Code Index MCP

🚀 Code Index MCP Server

Zoektを使用して、ローカルのソースコードを高速に検索するためのMCP（Model Context Protocol）サーバーです。

🚀 クイックスタート

このサーバーは、高速なローカルソースコード検索を実現するためのMCPサーバーです。以下に、インストール方法や使用方法を説明します。

✨ 主な機能

• 高速なコード検索：Zoektのトライグラムベースのインデックスを使用して、高速な部分文字列と正規表現のマッチングを実現します。
• ディレクトリごとのインデックス：インデックス化された各ディレクトリには、ユーザープロファイルに独自のインデックスが保存されます。
• 豊富なクエリ言語：正規表現、ファイルフィルター、言語フィルター、および論理演算子をサポートします。
• クロスプラットフォーム：macOSとLinuxで動作します。

📦 インストール

このサーバーは、MCP Registryで利用可能です。

事前ビルド済みのMCPBバンドルをダウンロードする（実験的）

GitHub Releasesページから、あなたのプラットフォームに適した.mcpbバンドルをダウンロードします。

• code-index-mcp-darwin-arm64.mcpb - macOS Apple Silicon
• code-index-mcp-darwin-amd64.mcpb - macOS Intel
• code-index-mcp-linux-amd64.mcpb - Linux x64
• code-index-mcp-linux-arm64.mcpb - Linux ARM64

.mcpbファイルは、バイナリとマニフェストを含むZIPアーカイブです。Claude Desktopで直接開くことでインストールできます。

手動インストール（推奨）

バイナリをコンピューターに取得するには、以下のいずれかの方法を行います。

リリースからダウンロード

GitHub Releasesにアクセスし、適切なファイル（mcpbではなく、あなたのプラットフォームに対応するtar/gzip圧縮されたもの）をダウンロードします。 例えば：

curl -sL https://github.com/trondhindenes/code-index-mcp/releases/download/1.0.13/code-index-mcp-darwin-arm64.tar.gz | tar xz
chmod +x code-index-mcp

Goを使用する

go install github.com/trondhindenes/code-index-mcp@latest

ソースからビルド

git clone https://github.com/trondhindenes/code-index-mcp
cd code-index-mcp
go build -o code-index-mcp .

📚 ドキュメント

設定

バイナリをローカルにインストールしたら、好みのツールに登録することができます。mcpbバンドルを介してインストールした場合は、これは必要ない場合がありますが、状況によって異なります。

Claude Desktop

Claude Desktopの設定（macOSでは~/Library/Application Support/Claude/claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "code-index": {
      "command": "/path/to/code-index-mcp"
    }
  }
}

Claude Code

以下のコマンドを実行します。

claude mcp add --scope user --transport stdio code-index /path/to/code-index-mcp

環境変数

• CODE_INDEX_DIR：デフォルトのインデックス保存場所を上書きします。

デフォルトのインデックス保存場所：

• macOS: ~/Library/Application Support/code-index/
• Linux: ~/.local/share/code-index/ または $XDG_DATA_HOME/code-index/

利用可能なツール

index_directory

高速検索用にソースコードディレクトリをインデックス化します。

パラメーター:

• directory (必須): インデックス化するディレクトリのパス

例:

ディレクトリ /Users/me/projects/myapp をインデックス化する

search_code

インデックス化されたディレクトリ全体でコードを検索します。コンテキストウィンドウの使用を最小限に抑えるために、コンパクトなgrepのような出力を返します。

パラメーター:

• query (必須): Zoekt構文を使用した検索クエリ
• directory (オプション): 検索を特定のインデックス化されたディレクトリに制限する
• max_files (オプション): 返す最大ファイル数（デフォルト: 20）
• max_lines_per_file (オプション): ファイルごとの最大マッチ数（デフォルト: 3）
• files_only (オプション): ファイルパスのみを返し、行内容を返さない（デフォルト: false）

出力形式:

/path/to/file.go:42: ここにマッチする行の内容
/path/to/file.go:58: 別のマッチする行
  ... このファイルにさらに5つのマッチがあります

クエリ構文の例:

• func main - 単純なテキスト検索
• file:\.go$ func main - .goファイルのみで検索
• lang:python class.*Model - Pythonファイルで検索
• -test func main - "test"を含むファイルを除外
• case:yes MyFunc - 大文字と小文字を区別する検索

list_indexes

すべてのインデックス化されたディレクトリとその場所を一覧表示します。

delete_index

特定のディレクトリのインデックスを削除します。

パラメーター:

• directory (必須): インデックスを削除するディレクトリのパス

index_info

インデックス化の設定に関する情報（保存場所など）を取得します。

スキップされるディレクトリ

インデックス化中に自動的にスキップされるディレクトリは以下の通りです。

• 隠しディレクトリ（.で始まるもの）
• node_modules, vendor, __pycache__
• target, build, dist
• venv, .venv, env, .env

スキップされるファイル

バイナリファイルや一般的な非コードファイルは自動的にスキップされます。

• 実行可能ファイル（.exe, .dll, .so, .dylib）
• アーカイブ（.zip, .tar, .gz）
• 画像（.png, .jpg, .gif）
• ドキュメント（.pdf, .doc, .docx）

📄 ライセンス

MITライセンスの下で公開されています。