claude-context

环境要求

• 已安装 Node.js（命令使用 npx，无需全局安装）
• 已安装 Claude Code 或其他支持 MCP 的编程客户端
• 一个 OpenAI API Key（OPENAI_API_KEY）
• 一个 Zilliz Cloud（Milvus）公网访问地址与 API Key

安装与启动步骤

1. 1准备密钥信息

   提前准备好 OPENAI_API_KEY、Zilliz Cloud 实例的公网访问地址（MILVUS_ADDRESS）与 API Key（MILVUS_TOKEN），下面配置会用到。

2. 2注册 MCP 服务

   用 claude mcp add 把 claude-context 写入 Claude Code 的 MCP 配置，把三处示例值替换成你自己的真实密钥。

   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

   复制

3. 3进入项目启动

   切换到你要索引的代码库目录，再运行 claude 启动 Claude Code，MCP 服务会随会话加载。

   cd your-project-directory
   claude

   复制

4. 4索引代码库

   在 Claude Code 会话中输入 Index this codebase，把整个代码库向量化写入向量数据库，大仓库耗时较久。

5. 5查看索引状态

   输入 Check the indexing status 确认索引是否完成；未完成时搜索可能返回不完整结果。

6. 6开始语义搜索

   索引完成后即可用自然语言检索代码，例如输入 Find functions that handle user authentication。

7. 7其他客户端接入

   非 Claude Code 客户端可用 stdio 方式直接运行该服务，并按各客户端要求填写同样的三个环境变量。

   npx @zilliz/claude-context-mcp@latest

   复制

关键配置

如何确认成功

在 Claude Code 中输入 Check the indexing status，能看到索引进度或完成状态即说明 MCP 服务已正常连接并可用。

常见问题

注意事项

• claude mcp add 中的三个 -e 值必须替换为你自己的真实密钥，示例值无法直接使用。
• 索引大仓库会消耗较多时间和 embedding 调用额度，建议在业务空闲时执行。
• Windows 用户如需搭建开发环境，需安装 Git for Windows、Node.js，并全局安装 pnpm：npm install -g pnpm。
• 开发环境依赖安装命令为 pnpm install，需在项目根目录执行。