Zilliz 开源 claude-context:让整个代码库成为 Claude Code 的上下文

Zilliz 开源 claude-context:让整个代码库成为 Claude Code 的上下文

向量数据库公司 Zilliz 开源的 claude-context(github.com/zilliztech/claude-context)正在成为 GitHub 上最热门的 MCP(Model Context Protocol)项目之一。该项目已达到 10200 星标,本周新增约 3700 星,拥有 194 次提交和 39 个开放 PR。

解决什么问题

Claude Code 等编程 Agent 的上下文窗口虽然越来越大,但面对几十万行代码的真实项目,直接塞入整个代码库既不经济也不高效。claude-context 的思路是用向量检索代替上下文堆砌

  1. 先将代码库索引为向量数据库(支持 Milvus/Zilliz Cloud)
  2. 通过 MCP 协议为 Claude Code 提供代码搜索能力
  3. Agent 按需检索相关代码片段,而不是被动接收全部上下文

这本质上是为编程 Agent 增加了一个”外部记忆层”。

核心能力

项目采用多包架构(packages/ 目录下有多个子包),支持:

  • 语义搜索:通过自然语言查询定位相关代码文件和函数
  • 跨文件关联:追踪依赖关系和调用链,提供完整的代码上下文
  • 多模型支持:不仅支持 Claude,也兼容 Gemini 等其他 LLM(Add custom gemini baseurl support
  • 去重优化:最近的 PR(#333)增加了搜索结果去重功能,避免重叠结果浪费上下文
  • 评估框架:内置 evaluation/ 目录,包含 case study 和基准测试

最新版本为 v0.1.3,支持 Node.js 24。

与替代方案对比

方案原理适用规模延迟集成难度
claude-context向量检索 + MCP大型项目(百万行级)低(毫秒级检索)中等(需部署 Milvus)
直接塞入上下文LLM 原生上下文窗口中小型项目无额外延迟
文件系统搜索grep/ripgrep 精确匹配任意规模低但需手动
Repo-specific RAG自建 RAG 管线任意规模中等

claude-context 的定位很明确:面向使用 Claude Code 等 MCP 兼容 Agent 的团队,解决”项目太大、上下文不够”的痛点。如果项目较小,直接利用 Agent 的上下文窗口可能更简单;但超过几万行代码后,向量检索的按需召回方式更有优势。

快速上手

# 克隆项目
git clone https://github.com/zilliztech/claude-context.git
cd claude-context

# 安装依赖
npm install

# 启动 MCP 服务器(需要 Milvus 实例)
npx claude-context serve --milvus-url http://localhost:19530

# 在 Claude Code 中配置 MCP
# 编辑 ~/.claude/settings.json,添加:
# "mcpServers": { "claude-context": { "command": "npx", "args": ["claude-context", "serve"] } }

需要本地或云端部署 Milvus 向量数据库。项目文档中提供了 Docker Compose 一键启动 Milvus 的方式。

主要来源