zilliztech/claude-context

Code search MCP for Claude Code. Make entire codebase the context for any coding agent.

What it solves

Claude Context 解决了在使用 AI 编码代理处理大型代码库时的“上下文窗口耗尽”和高成本问题。它不会将整个目录加载到 LLM——这既昂贵又常常超出 token 限制——而是只让代理从数百万行源代码中检索最相关的代码片段。

How it works

它作为 Model Context Protocol (MCP) 插件，将 AI 助手（如 Claude Code、Cursor 或 Windsurf）连接到向量数据库。系统使用以下管道处理代码库：

  1. Indexing：利用抽象语法树（AST）进行智能分块，并将生成的嵌入存储在向量数据库（如 Milvus 或 Zilliz Cloud）。
  2. Hybrid Search：结合 BM25（关键词搜索）和密集向量搜索（语义搜索），根据自然语言查询查找代码。
  3. Incremental Updates：使用 Merkle 树仅重新索引已更改的文件，确保索引保持最新而无需完整重建。
  4. Integration：提供 index_codebase 与 search_code 等工具，AI 代理可以调用这些工具将特定、相关的代码直接拉入其活动上下文。

Who it’s for

适用于使用 AI 编码代理并处理大规模软件项目的开发者，旨在提升检索准确性，同时降低 token 使用量和 API 成本。

Highlights

  • Broad Compatibility：兼容多种 MCP 客户端，包括 Claude Code、Cursor、Windsurf、VS Code 和 Gemini CLI。
  • Multi-Language Support：支持 TypeScript、JavaScript、Python、Java、C++、C#、Go、Rust、PHP、Ruby、Swift、Kotlin、Scala 和 Markdown。
  • Flexible Embeddings：兼容多种嵌入提供商，包括 OpenAI、VoyageAI、Ollama 和 Gemini。
  • Efficiency：相较于加载完整目录，演示约可减少 40% token 使用，同时保持检索质量。