mcpField
C
Claude Context

Claude Context

ローカル
github.com/zilliztechAI・エージェント12.7k15 週間前に更新

Claude Context について

Claude Context は、Claude Code などのAIコーディングエージェントにセマンティックなコード検索を追加するMCPサーバーです。コードベースをベクターデータベースに保存し、関連するコードのみをコンテキストに渡すため、大規模プロジェクトでのトークン使用量を抑えられます。

主な機能

  1. 01インデックス済みコードベースのセマンティック検索
  2. 02BM25 と密ベクトルを組み合わせたハイブリッド検索
  3. 03Merkle ツリーによる差分インデックス更新
  4. 04AST ベースのコード分割
  5. 05ファイル拡張子・除外ルール・埋め込みモデルの設定
  6. 06Zilliz Cloud によるベクターデータの保存

活用シーン

  1. 01大規模コードベースで自然言語を使い関連関数を探す
  2. 02トークン使用量を抑えながらコーディングエージェントにコード文脈を提供する
  3. 03Claude Code、Cursor、Gemini CLI にコード検索を追加する

MCP 対応

stdio トランスポートで動作するMCPサーバーで、MCPクライアントに index_codebase、search_code、clear_index、get_indexing_status の4つのツールを公開します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"claude-context": {
"command": "npx",
"args": [
"-y",
"@zilliz/claude-context-mcp"
],
"env": {
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"MILVUS_TOKEN": "<MILVUS_TOKEN>"
}
}
}
}
起動コマンドnpx -y @zilliz/claude-context-mcp
設定が必要な環境変数
OPENAI_API_KEYシークレット
MILVUS_TOKENシークレット

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@zilliz/claude-context-mcp

ツール

4

掲載時のツール一覧 · 3 週間前に更新

パラメーター型必須説明
pathstringはいインデックスを作成するコードベースディレクトリの絶対パス。
forcebooleanいいえすでにインデックスが作成されていても、強制的に再インデックスします
splitterenumいいえ使用するコードスプリッター:'ast' は自動フォールバック付きの構文対応分割、'langchain' は文字ベースの分割ast | langchain
customExtensionsarrayいいえ任意:デフォルトに加えて含めるファイル拡張子(例:['.vue', '.svelte', '.astro'])。拡張子にはドットの接頭辞を含めてください。含まれていない場合は自動的に追加されます
ignorePatternsarrayいいえ任意:デフォルトに加えて特定のファイル/ディレクトリを除外する追加の無視パターン。ユーザーがカスタムの無視パターンを明示的に要求した場合にのみ、このパラメーターを含めてください(例:['static/**', '*.tmp', 'private/**'])

詳細

README の画像

🆕 Claude Code 用の永続メモリをお探しですか? memsearch Claude Code plugin をご覧ください。Markdown を中心にしたメモリシステムで、AI エージェントにセッションをまたいだ長期記憶を提供します。

コードベース全体を Claude のコンテキストとして活用

License Node.js Documentation VS Code Marketplace npm - core npm - mcp Twitter DeepWiki discord zilliztech/claude-context | Trendshift

Claude Context は、Claude Code やその他の AI コーディングエージェントにセマンティックコード検索を追加する MCP プラグインです。コードベース全体から詳細なコンテキストを提供します。

🧠 コードベース全体をコンテキストとして活用:Claude Context はセマンティック検索を使用して、数百万行のコードから関連するコードをすべて見つけます。複数回にわたる探索は不要です。検索結果を Claude のコンテキストに直接取り込みます。

💰 大規模なコードベースでもコストを抑制:リクエストのたびにディレクトリ全体を Claude に読み込ませると非常に高額になりますが、Claude Context はコードベースをベクトルデータベースに効率よく保存し、関連するコードだけをコンテキストとして使用するため、コストを抑えられます。


🚀 デモ

img

Model Context Protocol(MCP)を使うと、Claude Context をお気に入りの AI コーディングアシスタント(Claude Code など)と連携できます。

クイックスタート

前提条件
Zilliz Cloud で無料のベクトルデータベースを取得する 👈

Claude Context にはベクトルデータベースが必要です。Zilliz Cloud で登録すると、API キーを取得できます。

README の画像

Personal Key をコピーし、設定例の your-zilliz-cloud-api-key と置き換えてください。

埋め込みモデル用の OpenAI API キーを取得する

埋め込みモデルには OpenAI API キーが必要です。OpenAI に登録すると取得できます。

API キーは次のような形式で、必ず sk- で始まります。
キーをコピーし、以下の設定例で your-openai-api-key として使用してください。

Claude Code 用の MCP を設定する

システム要件:

  • Node.js >= 20.0.0
設定

コマンドラインインターフェイスを使用して、Claude Context 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

MCP サーバーの管理について詳しくは、Claude Code MCP のドキュメントをご覧ください。

その他の MCP クライアント設定
OpenAI Codex CLI

Codex CLI は TOML 設定ファイルを使用します。

  1. ~/.codex/config.toml ファイルを作成または編集します。

  2. 次の設定を追加します。

# IMPORTANT: the top-level key is `mcp_servers` rather than `mcpServers`.
[mcp_servers.claude-context]
command = "npx"
args = ["@zilliz/claude-context-mcp@latest"]
env = { "OPENAI_API_KEY" = "your-openai-api-key", "MILVUS_TOKEN" = "your-zilliz-cloud-api-key" }
# Optional: override the default 10s startup timeout
startup_timeout_ms = 20000
  1. ファイルを保存し、Codex CLI を再起動して変更を適用します。
Gemini CLI

Gemini CLI では、JSON ファイルを使った手動設定が必要です。

  1. ~/.gemini/settings.json ファイルを作成または編集します。
  2. 次の設定を追加します。
{
  "mcpServers": {
    "claude-context": {
      "command": "npx",
      "args": ["@zilliz/claude-context-mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
      }
    }
  }
}
  1. ファイルを保存し、Gemini CLI を再起動して変更を適用します。
Qwen Code

~/.qwen/settings.json ファイルを作成または編集し、次の設定を追加します。

{
  "mcpServers": {
    "claude-context": {
      "command": "npx",
      "args": ["@zilliz/claude-context-mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
      }
    }
  }
}
Cursor

Settings -> Cursor Settings -> MCP -> Add new global MCP server の順に移動します。

次の設定を Cursor の ~/.cursor/mcp.json ファイルに貼り付ける方法をおすすめします。プロジェクトフォルダーに .cursor/mcp.json を作成して、特定のプロジェクトにインストールすることもできます。詳しくはCursor MCP のドキュメントをご覧ください。

{
  "mcpServers": {
    "claude-context": {
      "command": "npx",
      "args": ["-y", "@zilliz/claude-context-mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
      }
    }
  }
}
Void

Settings -> MCP -> Add MCP Server の順に移動します。

次の設定を Void の MCP 設定に追加します。

{
  "mcpServers": {
    "code-context": {
      "command": "npx",
      "args": ["-y", "@zilliz/claude-context-mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
      }
    }
  }
}
Claude Desktop

Claude Desktop の設定に次の内容を追加します。

{
  "mcpServers": {
    "claude-context": {
      "command": "npx",
      "args": ["@zilliz/claude-context-mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
      }
    }
  }
}
Windsurf

Windsurf は JSON ファイルによる MCP 設定に対応しています。次の設定を Windsurf の MCP 設定に追加します。

{
  "mcpServers": {
    "claude-context": {
      "command": "npx",
      "args": ["-y", "@zilliz/claude-context-mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
      }
    }
  }
}
VS Code

Claude Context MCP サーバーは、MCP 互換の拡張機能を使って VS Code で利用できます。次の設定を VS Code の MCP 設定に追加します。

{
  "mcpServers": {
    "claude-context": {
      "command": "npx",
      "args": ["-y", "@zilliz/claude-context-mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
      }
    }
  }
}
Cherry Studio

Cherry Studio では、設定画面から MCP サーバーを視覚的に設定できます。JSON 設定を直接手動で指定することはできませんが、GUI から新しいサーバーを追加できます。

  1. Settings → MCP Servers → Add Server に移動します。
  2. サーバーの詳細を入力します。
    • Name:claude-context
    • Type:STDIO
    • Command:npx
    • Arguments:["-y", "@zilliz/claude-context-mcp@latest"]
    • Environment Variables:
      • OPENAI_API_KEY:your-openai-api-key
      • MILVUS_ADDRESS:your-zilliz-cloud-public-endpoint
      • MILVUS_TOKEN:your-zilliz-cloud-api-key
  3. 設定を保存して、サーバーを有効にします。
Cline

Cline は、MCP サーバーの管理に JSON 設定ファイルを使用します。提供されている MCP サーバー設定を統合するには、次の手順に従います。

  1. Cline を開き、上部のナビゲーションバーにある MCP Servers アイコンをクリックします。

  2. Installed タブを選択し、Advanced MCP Settings をクリックします。

  3. cline_mcp_settings.json ファイルに次の設定を追加します。

{
  "mcpServers": {
    "claude-context": {
      "command": "npx",
      "args": ["@zilliz/claude-context-mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
      }
    }
  }
}
  1. ファイルを保存します。
Augment

Augment Code で Claude Context MCP を設定するには、グラフィカルインターフェイスを使う方法と手動で設定する方法があります。

A. Augment Code の UI を使用する
  1. ハンバーガーメニューをクリックします。

  2. Settings を選択します。

  3. Tools セクションに移動します。

  4. + Add MCP ボタンをクリックします。

  5. 次のコマンドを入力します。

    npx @zilliz/claude-context-mcp@latest
    
  6. MCP の名前を Claude Context にします。

  7. Add ボタンをクリックします。


B. 手動設定
  1. Cmd/Ctrl Shift P を押すか、Augment パネルのハンバーガーメニューを開きます
  2. Edit Settings を選択します
  3. Advanced の下にある Edit in settings.json をクリックします
  4. augment.advanced オブジェクトの mcpServers 配列にサーバー設定を追加します
"augment.advanced": { 
  "mcpServers": [ 
    { 
      "name": "claude-context", 
      "command": "npx", 
      "args": ["-y", "@zilliz/claude-context-mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
      }
    }
  ]
}
Roo Code

Roo Code では、MCP サーバーに JSON 設定ファイルを使用します。

  1. Roo Code を開き、Settings → MCP Servers → Edit Global Config に移動します。

  2. mcp_settings.json ファイルに、次の設定を追加します。

{
  "mcpServers": {
    "claude-context": {
      "command": "npx",
      "args": ["@zilliz/claude-context-mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
      }
    }
  }
}
  1. ファイルを保存すると、サーバーが有効になります。
Zencoder

Zencoder は、JetBrains プラグイン版と VS Code プラグイン版の両方で、MCP ツールとサーバーに対応しています。

  1. Zencoder メニューを開きます(...)
  2. ドロップダウンメニューから Tools を選択します
  3. Add Custom MCP をクリックします
  4. 名前(例:Claude Context)と以下のサーバー設定を追加し、必ず Install ボタンをクリックします
{
    "command": "npx",
    "args": ["@zilliz/claude-context-mcp@latest"],
    "env": {
      "OPENAI_API_KEY": "your-openai-api-key",
      "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
      "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
    }
}

  1. Install ボタンをクリックして、サーバーを保存します。
LangChain/LangGraph

LangChain/LangGraph の統合例については、こちらの例をご覧ください。

その他の MCP クライアント

このサーバーは stdio トランスポートを使用し、標準の MCP プロトコルに準拠しています。次のコマンドを実行すれば、MCP 互換クライアントと統合できます。

npx @zilliz/claude-context-mcp@latest

コードベースでの使用方法
  1. Claude Code を開きます

    cd your-project-directory
    claude
    
  2. コードベースをインデックス化します:

    Index this codebase
    
  3. インデックス作成のステータスを確認します:

    Check the indexing status
    
  4. 検索を開始します:

    Find functions that handle user authentication
    

🎉 これで完了です! Claude Code でセマンティックコード検索を利用できるようになりました。


環境変数の設定

MCP の環境変数設定について詳しくは、環境変数ガイドをご覧ください。

異なる埋め込みモデルの使用

カスタム埋め込みモデル(OpenAI の text-embedding-3-large や VoyageAI の voyage-code-3 など)を設定する方法について詳しくは、プロバイダーごとの詳細なセットアップ手順が記載されたMCP 設定例をご覧ください。

ファイルの包含・除外ルール

ファイルの包含・除外ルールとそのカスタマイズ方法について詳しくは、ファイルの包含・除外ルールをご覧ください。

利用可能なツール
1. index_codebase

ハイブリッド検索(BM25 + 密ベクトル検索)のために、コードベースのディレクトリをインデックス化します。

2. search_code

自然言語のクエリを使って、ハイブリッド検索(BM25 + 密ベクトル検索)でインデックス化されたコードベースを検索します。

3. clear_index

指定したコードベースの検索インデックスを消去します。

4. get_indexing_status

コードベースの現在のインデックス作成状況を取得します。インデックス作成中のコードベースについては進捗率を、インデックス作成済みのコードベースについては完了状況を表示します。


📊 評価

当社の統制評価では、検索品質が同等の条件下で、Claude Context MCP によりトークンを約 40%削減できることが示されています。これにより、本番環境で大幅なコストと時間の削減が実現します。また、トークンコンテキスト長に制限がある場合、Claude Context を使用すると、より優れた検索結果と回答が得られることを意味します。

MCP 効率分析

評価方法と結果について詳しくは、評価ディレクトリをご覧ください。


🏗️ アーキテクチャ

README の画像

🔧 実装の詳細
  • 🔍 ハイブリッドコード検索:「ユーザー認証を処理する関数を探して」 のような質問をすると、高度なハイブリッド検索(BM25 + 密ベクトル)を使って、関連性が高くコンテキストが豊富なコードをすぐに取得できます。
  • 🧠 コンテキストを考慮:大規模なコードベースを探索し、数百万行に及ぶコードでも、コードベースのさまざまな部分がどのように関連しているかを理解できます。
  • ⚡ 増分インデックス作成:Merkle ツリーを使用して、変更されたファイルのみを効率的に再インデックスします。
  • 🧩 インテリジェントなコード分割:コードを抽象構文木(AST)で解析して分割します。
  • 🗄️ スケーラブル:コードベースの規模を問わず、スケーラブルなベクトル検索を実現する Zilliz Cloud と統合できます。
  • 🛠️ カスタマイズ可能:ファイル拡張子、無視するパターン、埋め込みモデルを設定できます。
コアコンポーネント

Claude Context は、3 つの主要パッケージを含むモノレポです。

  • @zilliz/claude-context-core:埋め込みとベクトルデータベースの統合に対応したコアのインデックス作成エンジン
  • VSCode Extension:Visual Studio Code 用のセマンティックコード検索拡張機能
  • @zilliz/claude-context-mcp:AI エージェント統合用の Model Context Protocol サーバー
対応テクノロジー
  • 埋め込みプロバイダー:OpenAI、VoyageAI、Ollama、Gemini
  • ベクトルデータベース:Milvus または Zilliz Cloud(サービスとして提供されるフルマネージドのベクトルデータベース)
  • コード分割ツール:AST ベースの分割ツール(自動フォールバック対応)、LangChain の文字ベース分割ツール
  • 言語:TypeScript、JavaScript、Python、Java、C++、C#、Go、Rust、PHP、Ruby、Swift、Kotlin、Scala、Markdown
  • 開発ツール:VSCode、Model Context Protocol

📦 Claude Context のその他の使い方

AI アシスタントで Claude Context を使うには MCP が推奨されますが、直接使用したり、VSCode 拡張機能を介して使用したりすることもできます。

Core パッケージでアプリケーションを構築する

@zilliz/claude-context-core パッケージは、コードのインデックス作成とセマンティック検索に必要な基本機能を提供します。

import { Context, MilvusVectorDatabase, OpenAIEmbedding } from '@zilliz/claude-context-core';

// Initialize embedding provider
const embedding = new OpenAIEmbedding({
    apiKey: process.env.OPENAI_API_KEY || 'your-openai-api-key',
    model: 'text-embedding-3-small'
});

// Initialize vector database
const vectorDatabase = new MilvusVectorDatabase({
    address: process.env.MILVUS_ADDRESS || 'your-zilliz-cloud-public-endpoint',
    token: process.env.MILVUS_TOKEN || 'your-zilliz-cloud-api-key'
});

// Create context instance
const context = new Context({
    embedding,
    vectorDatabase
});

// Index your codebase with progress tracking
const stats = await context.indexCodebase('./your-project', (progress) => {
    console.log(`${progress.phase} - ${progress.percentage}%`);
});
console.log(`Indexed ${stats.indexedFiles} files, ${stats.totalChunks} chunks`);

// Perform semantic search
const results = await context.semanticSearch('./your-project', 'vector database operations', 5);
results.forEach(result => {
    console.log(`File: ${result.relativePath}:${result.startLine}-${result.endLine}`);
    console.log(`Score: ${(result.score * 100).toFixed(2)}%`);
    console.log(`Content: ${result.content.substring(0, 100)}...`);
});
VSCode 拡張機能

Claude Context を IDE に直接統合します。セマンティックコード検索とナビゲーションのための直感的なインターフェイスを提供します。

  1. 直接リンク:VS Code Marketplace からインストール
  2. 手動で検索:
    • VSCode で拡張機能ビューを開きます(Mac では Ctrl+Shift+X または Cmd+Shift+X)
    • 「Semantic Code Search」を検索します
    • インストールをクリックします

img

🛠️ 開発

開発環境のセットアップ
前提条件
  • Node.js 20.x、22.x、または 24.x
  • pnpm(推奨パッケージマネージャー)
クロスプラットフォームのセットアップ
# Clone repository
git clone https://github.com/zilliztech/claude-context.git
cd claude-context

# Install dependencies
pnpm install

# Build all packages
pnpm build

# Start development mode
pnpm dev
Windows 固有のセットアップ

Windows では、以下を確認してください。

  • Git for Windows が適切な改行コード設定でインストールされていること
  • Node.js が公式インストーラーまたはパッケージマネージャーを使用してインストールされていること
  • pnpm がグローバルにインストールされていること:npm install -g pnpm
# Windows PowerShell/Command Prompt
git clone https://github.com/zilliztech/claude-context.git
cd claude-context

# Configure git line endings (recommended)
git config core.autocrlf false

# Install dependencies
pnpm install

# Build all packages (uses cross-platform scripts)
pnpm build

# Start development mode
pnpm dev
ビルド
# Build all packages (cross-platform)
pnpm build

# Build specific package
pnpm build:core
pnpm build:vscode
pnpm build:mcp

# Performance benchmarking
pnpm benchmark
Windows でのビルドに関する注意
  • すべてのビルドスクリプトは rimraf を使用してクロスプラットフォームに対応しています
  • ビルドキャッシュが有効になっており、以降のビルドを高速化できます
  • PowerShell とコマンドプロンプトのどちらでも同様に動作します
サンプルの実行
# Development with file watching
cd examples/basic-usage
pnpm dev

📖 サンプル

使用方法の完全な例については、/examples ディレクトリを確認してください。

  • 基本的な使い方:インデックス作成と検索の簡単な例

❓ FAQ

よくある質問:

❓ 詳しい回答やその他のトラブルシューティングのヒントについては、FAQ ガイドをご覧ください。

🔧 問題が発生しましたか? 手順に沿った解決方法については、トラブルシューティングガイドをご覧ください。

📚 さらにサポートが必要ですか? 詳細なガイドやトラブルシューティングのヒントについては、ドキュメント一式をご確認ください。


🤝 コントリビューション

コントリビューションを歓迎します!始め方については、コントリビューションガイドをご覧ください。

パッケージ別のコントリビューションガイド:


🗺️ ロードマップ

  • 理解を深めるための AST ベースのコード分析
  • 追加の埋め込みプロバイダーへの対応
  • エージェントベースの対話型検索モード
  • 強化されたコード分割戦略
  • 検索結果のランキング最適化
  • 堅牢な Chrome 拡張機能

📄 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については、LICENSEファイルをご覧ください。


🔗 リンク

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。