README

!

 🆕 Looking for persistent memory for Claude Code? Check out memsearch Claude Code plugin — a markdown-first memory system that gives your AI agent long-term memory across sessions.

 Your entire codebase as Claude's context













Claude Context is an MCP plugin that adds semantic code search to Claude Code and other AI coding agents, giving them deep context from your entire codebase.

🧠 Your Entire Codebase as Context: Claude Context uses semantic search to find all relevant code from millions of lines. No multi-round discovery needed. It brings results straight into the Claude's context.

💰 Cost-Effective for Large Codebases: Instead of loading entire directories into Claude for every request, which can be very expensive, Claude Context efficiently stores your codebase in a vector database and only uses related code in context to keep your costs manageable.

---

 🚀 Demo

!img

Model Context Protocol (MCP) allows you to integrate Claude Context with your favorite AI coding assistants, e.g. Claude Code.

 Quick Start

 Prerequisites


Get a free vector database on Zilliz Cloud 👈

Claude Context needs a vector database. You can sign up on Zilliz Cloud to get an API key.

!

Copy your Personal Key to replace your-zilliz-cloud-api-key in the configuration examples.



Get OpenAI API Key for embedding model

You need an OpenAI API key for the embedding model. You can get one by signing up at OpenAI.  

Your API key will look like this: it always starts with sk-.  
Copy your key and use it in the configuration examples below as your-openai-api-key.



 Configure MCP for Claude Code

System Requirements:

- Node.js = 20.0.0

 Configuration

Use the command line interface to add the Claude Context MCP server:

bash
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


See the Claude Code MCP documentation for more details about MCP server management.

 Other MCP Client Configurations


OpenAI Codex CLI

Codex CLI uses TOML configuration files:

1. Create or edit the ~/.codex/config.toml file.

2. Add the following configuration:

toml
 IMPORTANT: the top-level key is mcp_servers rather than mcpServers.
[mcp_servers.claude-context]
command = "npx"
args = ["@zilliz/claude-context-mcp@latest"]
env = { "OPENAI_API_KEY" = "your-openai-api-key", "MILVUS_TOKEN" = "your-zilliz-cloud-api-key" }
 Optional: override the default 10s startup timeout
startup_timeout_ms = 20000


3. Save the file and restart Codex CLI to apply the changes.




Gemini CLI

Gemini CLI requires manual configuration through a JSON file:

1. Create or edit the ~/.gemini/settings.json file.
2. Add the following configuration:

json
{
  "mcpServers": {
    "claude-context": {
      "command": "npx",
      "args": ["@zilliz/claude-context-mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",