claude-context
CLI ツールzilliztech/claude-context
AIコーディングエージェントに全コードベースのセマンティック検索を提供するMCPプラグイン。
概要
Claude Context は MCP サーバーであり、Claude Code などの AI プログラミングアシスタントがコードベース全体に対してセマンティック検索を実行できるようにします。ベクトル埋め込みを使用して関連するコードスニペットを効率的に検索し、完全なディレクトリを読み込むことを避けてコストを削減します。
README プレビュー
\n\n> 🆕 **Looking for persistent memory for Claude Code?** Check out [memsearch Claude Code plugin](https://github.com/zilliztech/memsearch#for-claude-code-users) — a markdown-first memory system that gives your AI agent long-term memory across sessions.\n\n### Your entire codebase as Claude's context\n\n[](https://opensource.org/licenses/MIT)\n[](https://nodejs.org/)\n[](docs/)\n[](https://marketplace.visualstudio.com/items?itemName=zilliz.semanticcodesearch)\n[](https://www.npmjs.com/package/@zilliz/claude-context-core)\n[](https://www.npmjs.com/package/@zilliz/claude-context-mcp)\n[](https://twitter.com/zilliz_universe)\n[](https://deepwiki.com/zilliztech/claude-context)\n\n\n\n\n**Claude Context** is an MCP plugin that adds semantic code search to Claude Code and other AI coding agents, giving them deep context from your entire codebase.\n\n🧠 **Your Entire Codebase as Context**: Claude Context uses semantic search to find all relevant code from millions of lines. No multi-round discovery needed. It brings results straight into the Claude's context.\n\n💰 **Cost-Effective for Large Codebases**: Instead of loading entire directories into Claude for every request, which can be very expensive, Claude Context efficiently stores your codebase in a vector database and only uses related code in context to keep your costs manageable.\n\n---\n\n## 🚀 Demo\n\n\n\nModel Context Protocol (MCP) allows you to integrate Claude Context with your favorite AI coding assistants, e.g. Claude Code.\n\n## Quick Start\n\n### Prerequisites\n\n\nGet a free vector database on Zilliz Cloud 👈\n\nClaude Context needs a vector database. You can [sign up](https://cloud.zilliz.com/signup?utm_source=github&utm_medium=referral&utm_campaign=2507-codecontext-readme) on Zilliz Cloud to get an API key.\n\n\n\nCopy your Personal Key to replace `your-zilliz-cloud-api-key` in the configuration examples.\n\n\n\nGet OpenAI API Key for embedding model\n\nYou need an OpenAI API key for the embedding mode
FAQ (3)
トラブル対応なぜClaude Code MCPサーバーは起動時に「Address is required and could not be resolved from token」というエラーでクラッシュするのですか?
あなたのClaude Code MCP設定にMILVUS_ADDRESS環境変数がありません。MCPサーバーを追加する際にZilliz Cloudエンドポイントを必ず指定してください。例:
claude mcp add claude-context \\
-e OPENAI_API_KEY=sk-your-openai-api-key \\
-e MILVUS_TOKEN=your-zilliz-cloud-api-key \\
-e MILVUS_ADDRESS=your-zilliz-cloud-api-endpoint \\
-- npx @zilliz/claude-context-mcp@latestこれにより、「Address is required and could not be resolved from token」エラーを防げます。この修正は最新のREADMEに統合されています。
トラブル対応なぜ私の codebase は crash の後、毎 session で force-reindexing を続けるのですか?
これはv0.1.6における既知のバグです。インデックス作成が中断された後、スナップショットファイルが0/0で停止し、無限に再インデックスループが発生します。回避策:~/.context/mcp-codebase-snapshot.jsonを編集し、該当するコードベースの「indexedFiles」と「totalChunks」を、Milvusの実際の行数(Milvusの統計情報から取得)に合わせて更新してください。恒久的な修正は計画中です(トラック#295)。
トラブル対応なぜclaude-contextは、ignoreファイルに指定されているにもかかわらず、/Library/のようなルートレベルのディレクトリ内のファイルをまだインデックスするのですか?
claude-contextは、無視パターンにおける先頭のスラッシュ(ルートのみのマッチング)と末尾のスラッシュ(ディレクトリとその内容)を完全には解釈しません。Gitなどの標準ツールは/Library/を「ルートにあるLibraryフォルダとそのすべての内容を無視する」として扱います。回避策として、先頭のスラッシュを削除し、末尾のスラッシュを/**に置き換える(例:Library/**)か、単にスラッシュなしのLibraryを使用して、ディレクトリとそのファイルを再帰的に無視します。この問題は#200として追跡されています。