【claude-context】让 Claude 看懂你整个代码库的智能“上下文外挂”
Claude Context 是一个专为 AI 编程助手(如 Claude Code)设计的 Model Context Protocol(MCP)插件,它通过语义搜索技术,把你的整个代码库变成 Claude 可理解、可检索的“活上下文”,从而解决大项目中 AI 无法精准定位相关代码、反复提问效率低、上下文成本高等实际痛点。
主要功能与特性包括:
– ✅ 全代码库语义搜索:基于 AST 的智能代码分块 + 混合检索(BM25 + 向量),支持自然语言提问(例如“找出处理用户认证的函数”),直接返回高相关性代码片段;
– ✅ 成本优化的上下文供给:不加载整个目录,只动态注入最相关的代码片段,实测在同等检索质量下降低约 40% 的 token 消耗;
– ✅ 增量索引与高效维护:利用 Merkle 树识别文件变更,仅重索引修改部分,大幅缩短大型代码库的更新耗时;
– ✅ 多平台无缝集成:原生支持 Claude Code、Cursor、VS Code、Gemini CLI、Qwen Code、Windsurf、Roo Code 等主流 MCP 客户端;
– ✅ 灵活可配置:支持多种嵌入模型(OpenAI、VoyageAI、Ollama、Gemini)、自定义文件包含/排除规则、多语言(TS/JS/Python/Java/Rust 等 14+ 种)。
安装与快速使用示例(以 Claude Code 为例):
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
配置完成后,在 Claude Code 中执行以下三步即可启用:
1. cd your-project-directory
2. 输入指令:Index this codebase
3. 输入自然语言查询:Find functions that handle user authentication
该项目适合以下场景和用户:
– 中大型工程团队:代码库动辄数十万行,传统全文搜索或手动复制粘贴上下文已不可持续;
– AI 编程重度使用者:依赖 Claude Code、Cursor、Windsurf 等工具进行日常开发、重构、调试或文档生成;
– 关注成本与效率的开发者:希望减少无效 token 消耗,提升 AI 回答准确率与响应速度;
– 需要跨文件/跨模块理解逻辑的维护者:例如接手遗留系统、做安全审计或架构分析。
总结:Claude Context 并非又一个代码补全工具,而是一个真正让 AI “读懂项目”的上下文基础设施——它把向量检索、AST 分析和 MCP 协议巧妙结合,落地扎实,配置路径清晰,且已在多个主流 AI 编程客户端中开箱即用。对于正在被“上下文不足”困扰的开发者来说,这是一个值得立即尝试的实用增强;建议访问其主页获取更详细信息。
