首页MCPzilliztech/claude-context
zilliztech

claude-context

AIVector DatabaseSemantic SearchMCPLLMCodebase Analysis
前往 GitHub →
87

// 项目简介

Claude Context 是一个 MCP 插件,通过将整个代码库索引到向量数据库中,为 AI 编程助手提供语义代码搜索功能。它通过仅向 AI 提供相关的代码片段而非加载整个目录,显著降低了成本并提高了检索质量。该工具支持增量索引、基于 AST 的代码分块,并能与各种 AI 助手和 IDE 无缝集成。

// 技术分析

Claude Context 是一种符合 MCP 标准的架构,旨在为 AI 编码代理提供对整个代码库的深度语义感知。通过利用混合搜索(BM25 + 稠密向量)和基于 AST 的分块技术,它解决了将大型存储库加载到 LLM 中时遇到的上下文窗口限制和高 Token 成本问题。该项目通过使用 Merkle 树进行增量索引来优先考虑效率,确保仅处理修改过的代码,从而显著优化了性能并降低了运营开销。

// 核心亮点

01
实现了结合 BM25 和稠密向量的混合搜索,以确保高度相关的代码检索。
02
利用基于 AST 的代码分块技术,在索引过程中保持代码的逻辑结构。
03
通过 Merkle 树支持增量索引,仅更新已更改的文件,从而最大限度地减少冗余处理。
04
与传统的上下文加载方法相比,Token 消耗量减少了约 40%,降低了大型项目的成本。
05
提供灵活的模块化架构,支持多种嵌入提供程序和向量数据库后端,如 Zilliz Cloud 或 Milvus。
06
通过 Model Context Protocol (MCP) 和专用的 VS Code 扩展,与各种 AI 编码助手具有广泛的兼容性。

// 典型使用场景

01
使用自然语言查询为 AI Agent 提供语义代码搜索功能
02
为大型项目提供高性价比的代码库上下文管理方案
03
通过增量索引和检索提升开发人员的工作效率

// 快速开始

首先,请确保已安装 Node.js(20.x 或 22.x 版本),并获取 OpenAI API 密钥以及 Zilliz Cloud 向量数据库端点。您可以通过使用 'npx @zilliz/claude-context-mcp@latest' 命令并输入您的凭据,将 MCP 服务器添加到您首选的 AI 助手(如 Claude Code、Cursor 或 Cline)中来集成该工具。配置完成后,只需在您的助手中运行 'Index this codebase' 即可开始构建您的语义搜索索引。