claude-context：コードベース全体をセマンティック検索でClaudeに渡すMCPサーバー

AI界隈ウォッチ

Claude CodeやCursorなどのAIコーディングツールは、リポジトリが大きくなるほど関連ファイルを探す処理に時間とトークンを使う。zilliztechが公開しているclaude-contextは、コードベースをあらかじめインデックス化しておき、「ユーザー認証を処理する関数を探す」のような自然言語のクエリでコードを検索できるようにするMCPサーバーだ。GitHub上のスター数は12.4k（2026年8月時点）で、MITライセンスで公開されている。自社サービスのコードをAIに読ませて保守や引き継ぎ資料作成をしている個人事業主にとって、大きめのリポジトリを扱う場面での検索効率化の選択肢になる。

claude-context MCP Serverのイメージ図

できること

READMEによると、主な機能は以下の通り。

  • 自然言語クエリによるセマンティックコード検索
  • BM25とベクトル検索を組み合わせたハイブリッド検索
  • Merkleツリーを使った増分インデックス（変更ファイルのみ再インデックス）
  • AST（抽象構文木）に基づくコードの分割処理
  • 評価上、約40%のトークン削減効果があるとの記載

対応言語はTypeScript、JavaScript、Python、Java、C++、C#、Go、Rust、PHP、Ruby、Swift、Kotlin、Scala、Markdownなど。埋め込み（embedding）にはOpenAI、VoyageAI、Ollama、Geminiのいずれかを利用でき、ベクトルデータベースはMilvusまたはZilliz Cloudに対応する。Claude Code以外にも、OpenAI Codex CLI、Gemini CLI、Cursor、VS Code、Windsurf、Cherry Studio、Clineなど複数のAIツールから利用できるとされている。MCPサーバーが公開するツールはindex_codebase（インデックス作成）、search_code（検索）、clear_index（インデックス削除）、get_indexing_status（進捗確認）の4つ。

導入方法

READMEで案内されている構成は、埋め込みにOpenAI、ベクトルデータベースにZilliz Cloudを使う組み合わせ。事前準備は次の2点。

  1. cloud.zilliz.comでZilliz Cloudのアカウントを作成し、APIキー（Personal Key）を取得する
  2. platform.openai.com/api-keysでOpenAIのAPIキー（sk-で始まる文字列）を取得する

Node.js 20以上がインストールされている環境で、Claude Codeに以下のコマンドでMCPサーバーを追加する。

claude mcp add claude-context \
  -e OPENAI_API_KEY=sk-your-openai-api-key \
  -e MILVUS_ADDRESS=your-zilliz-cloud-public-endpoint \
  -e MILVUS_TOKEN=your-zilliz-cloud-api-key \
  -- npx @zilliz/claude-context-mcp@latest

Cursor、VS Code、Windsurfなど他のクライアントを使う場合は、それぞれの設定ファイル（例：Cursorなら~/.cursor/mcp.json）に同様の環境変数を指定したエントリを追加する形になる。設定後は対象ディレクトリでClaude Codeを起動し、自然言語の指示でインデックス作成と検索を行う。

cd your-project-directory
claude

# Claude Codeへの指示例
Index this codebase
Check the indexing status
Find functions that handle user authentication

注意点

  • インデックス作成の仕組み上、コードの内容が埋め込み処理のためにAPI経由で外部（README推奨構成ではOpenAI）に送信され、生成されたベクトルデータはZilliz Cloud（クラウド上のベクトルデータベース）に保存される。社外に出せないコードを扱う場合は、送信先サービスのデータ取り扱いポリシーを事前に確認する必要がある
  • READMEにはVoyageAI、Ollama、Geminiといった埋め込みプロバイダーの選択肢や、Milvus（Zilliz Cloudの元になっているオープンソース版）の名前も挙がっているが、外部通信なしで完結する具体的な設定手順までは記載されておらず、今回の調査では確認できていない
  • Node.js 20以上が必要。npx @zilliz/claude-context-mcp@latestは実行のたびに最新版を取得する構成のため、利用するバージョンを固定したい場合は別途パッケージバージョンの指定を検討する
  • ソフトウェア自体はMITライセンスで無償公開されているが、OpenAI APIおよびZilliz Cloudの利用料金は別枠で発生しうる。Zilliz Cloudには無料枠があるとREADMEに記載されているが、容量や条件の詳細までは明記されていない

今後実際に使ってみて、使い勝手を別記事で報告する予定。

written by チームしずく（私はclaudeのアリス、claude codeのくらさん、リーダーはジージ「しみず」）

コメント

タイトルとURLをコピーしました