Skip to content zilliztech claude-context Repository navigation Code Issues 73 (73) Pull requests 34 (34) Agents Actions Projects Security and quality Insights Important update On April 24 we'll start using GitHub Copilot interaction data for AI model training unless you opt out. Review this update and manage your preferences in your GitHub account settings. Owner avatar claude-context Public zilliztech/claude-context Go to file t T Name fuleinist fuleinist docs: add MILVUS_ADDRESS to Claude Code quick-start (#310) 6a51b08 · 1 hour ago .github Add custom gemini baseurl support (#183) 8 months ago .vscode add vscode config to support extension development 10 months ago assets Add and optimize docs 8 months ago docs docs(mcp): explain indexing status semantics (#302) 1 hour ago evaluation add case study (#184) 8 months ago examples bump version to v0.1.3 8 months ago packages docs(mcp): explain indexing status semantics (#302) 1 hour ago python refactor class name 8 months ago scripts Add custom gemini baseurl support (#183) 8 months ago .env.example Add custom gemini baseurl support (#183) 8 months ago .eslintrc.js major code structure 10 months ago .gitignore add case study (#184) 8 months ago .npmrc Add custom gemini baseurl support (#183) 8 months ago CONTRIBUTING.md Add custom gemini baseurl support (#183) 8 months ago LICENSE major code structure 10 months ago README.md docs: add MILVUS_ADDRESS to Claude Code quick-start (#310) 1 hour ago build-benchmark.json Add custom gemini baseurl support (#183) 8 months ago package.json chore: bump version to 0.1.7 5 days ago pnpm-lock.yaml Add custom gemini baseurl support (#183) 8 months ago pnpm-workspace.yaml resolved 5 conflicts in chrome & core 10 months ago tsconfig.json Add custom gemini baseurl support (#183) 8 months ago Repository files navigation README Contributing MIT license

🆕 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 License Node.js Documentation VS Code Marketplace npm - core npm - mcp Twitter DeepWiki discord

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 👈 Get OpenAI API Key for embedding model Configure MCP for Claude Code System Requirements:

Node.js >= 20.0.0 and < 24.0.0 Claude Context is not compatible with Node.js 24.0.0, you need downgrade it first if your node version is greater or equal to 24.

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

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 Gemini CLI Qwen Code Cursor Void Claude Desktop Windsurf VS Code Cherry Studio Cline Augment Roo Code Zencoder LangChain/LangGraph Other MCP Clients Usage in Your Codebase Open Claude Code

cd your-project-directory claude Index your codebase:

Index this codebase Check indexing status:

Check the indexing status Start searching:

Find functions that handle user authentication 🎉 That's it! You now have semantic code search in Claude Code.

Environment Variables Configuration For more detailed MCP environment variable configuration, see our Environment Variables Guide.

Using Different Embedding Models To configure custom embedding models (e.g., text-embedding-3-large for OpenAI, voyage-code-3 for VoyageAI), see the MCP Configuration Examples for detailed setup instructions for each provider.

File Inclusion & Exclusion Rules For detailed explanation of file inclusion and exclusion rules, and how to customize them, see our File Inclusion & Exclusion Rules.

Available Tools

1. index_codebase Index a codebase directory for hybrid search (BM25 + dense vector).

2. search_code Search the indexed codebase using natural language queries with hybrid search (BM25 + dense vector).

3. clear_index Clear the search index for a specific codebase.

4. get_indexing_status Get the current indexing status of a codebase. Shows progress percentage for actively indexing codebases and completion status for indexed codebases.

📊 Evaluation Our controlled evaluation demonstrates that Claude Context MCP achieves ~40% token reduction under the condition of equivalent retrieval quality. This translates to significant cost and time savings in production environments. This also means that, under the constraint of limited token context length, using Claude Context yields better retrieval and answer results.

MCP Efficiency Analysis

For detailed evaluation methodology and results, see the evaluation directory.

🏗️ Architecture

🔧 Implementation Details 🔍 Hybrid Code Search: Ask questions like "find functions that handle user authentication" and get relevant, context-rich code instantly using advanced hybrid search (BM25 + dense vector). 🧠 Context-Aware: Discover large codebase, understand how different parts of your codebase relate, even across millions of lines of code. ⚡ Incremental Indexing: Efficiently re-index only changed files using Merkle trees. 🧩 Intelligent Code Chunking: Analyze code in Abstract Syntax Trees (AST) for chunking. 🗄️ Scalable: Integrates with Zilliz Cloud for scalable vector search, no matter how large your codebase is. 🛠️ Customizable: Configure file extensions, ignore patterns, and embedding models. Core Components Claude Context is a monorepo containing three main packages:

@zilliz/claude-context-core: Core indexing engine with embedding and vector database integration VSCode Extension: Semantic Code Search extension for Visual Studio Code @zilliz/claude-context-mcp: Model Context Protocol server for AI agent integration Supported Technologies Embedding Providers: OpenAI, VoyageAI, Ollama, Gemini Vector Databases: Milvus or Zilliz Cloud(fully managed vector database as a service) Code Splitters: AST-based splitter (with automatic fallback), LangChain character-based splitter Languages: TypeScript, JavaScript, Python, Java, C++, C#, Go, Rust, PHP, Ruby, Swift, Kotlin, Scala, Markdown Development Tools: VSCode, Model Context Protocol 📦 Other Ways to Use Claude Context While MCP is the recommended way to use Claude Context with AI assistants, you can also use it directly or through the VSCode extension.

Build Applications with Core Package The @zilliz/claude-context-core package provides the fundamental functionality for code indexing and semantic search.

import { Context, MilvusVectorDatabase, OpenAIEmbedding } from '@zilliz/claude-context-core';

// Initialize embedding provider const embedding = new OpenAIEmbedding({ apiKey: process.env.OPENAI_API_KEY || 'your-openai-api-key', model: 'text-embedding-3-small' });

// Initialize vector database const vectorDatabase = new MilvusVectorDatabase({ address: process.env.MILVUS_ADDRESS || 'your-zilliz-cloud-public-endpoint', token: process.env.MILVUS_TOKEN || 'your-zilliz-cloud-api-key' });

// Create context instance const context = new Context({ embedding, vectorDatabase });

// Index your codebase with progress tracking const stats = await context.indexCodebase('./your-project', (progress) => { console.log(${progress.phase} - ${progress.percentage}%); }); console.log(Indexed ${stats.indexedFiles} files, ${stats.totalChunks} chunks);

// Perform semantic search const results = await context.semanticSearch('./your-project', 'vector database operations', 5); results.forEach(result => { console.log(File: ${result.relativePath}:${result.startLine}-${result.endLine}); console.log(Score: ${(result.score * 100).toFixed(2)}%); console.log(Content: ${result.content.substring(0, 100)}...); }); VSCode Extension Integrates Claude Context directly into your IDE. Provides an intuitive interface for semantic code search and navigation.

Direct Link: Install from VS Code Marketplace Manual Search: Open Extensions view in VSCode (Ctrl+Shift+X or Cmd+Shift+X on Mac) Search for "Semantic Code Search" Click Install img 🛠️ Development Setup Development Environment Prerequisites Node.js 20.x or 22.x pnpm (recommended package manager) Cross-Platform Setup

Clone repository

git clone https://github.com/zilliztech/claude-context.git cd claude-context

Install dependencies

pnpm install

Build all packages

pnpm build

Start development mode

pnpm dev Windows-Specific Setup On Windows, ensure you have:

Git for Windows with proper line ending configuration Node.js installed via the official installer or package manager pnpm installed globally: npm install -g pnpm

Windows PowerShell/Command Prompt

git clone https://github.com/zilliztech/claude-context.git cd claude-context

Configure git line endings (recommended)

git config core.autocrlf false

Install dependencies

pnpm install

Build all packages (uses cross-platform scripts)

pnpm build

Start development mode

pnpm dev Building

Build all packages (cross-platform)

pnpm build

Build specific package

pnpm build:core pnpm build:vscode pnpm build:mcp

Performance benchmarking

pnpm benchmark Windows Build Notes All build scripts are cross-platform compatible using rimraf Build caching is enabled for faster subsequent builds Use PowerShell or Command Prompt - both work equally well Running Examples

Development with file watching

cd examples/basic-usage pnpm dev 📖 Examples Check the /examples directory for complete usage examples:

Basic Usage: Simple indexing and search example ❓ FAQ Common Questions:

What files does Claude Context decide to embed? Can I use a fully local deployment setup? Does it support multiple projects / codebases? How does Claude Context compare to other coding tools? ❓ For detailed answers and more troubleshooting tips, see our FAQ Guide.

🔧 Encountering issues? Visit our Troubleshooting Guide for step-by-step solutions.

📚 Need more help? Check out our complete documentation for detailed guides and troubleshooting tips.

🤝 Contributing We welcome contributions! Please see our Contributing Guide for details on how to get started.

Package-specific contributing guides:

Core Package Contributing MCP Server Contributing VSCode Extension Contributing 🗺️ Roadmap AST-based code analysis for improved understanding Support for additional embedding providers Agent-based interactive search mode Enhanced code chunking strategies Search result ranking optimization Robust Chrome Extension 📄 License This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Links GitHub Repository VSCode Marketplace Milvus Documentation Zilliz Cloud About Code search MCP for Claude Code. Make entire codebase the context for any coding agent.

github.com/zilliztech/claude-context/tree/master/docs Topics nodejs agent typescript mcp code-search openai vscode-extension code-generation cursor merkle-tree semantic-search embedding rag vector-database gemini-cli agentic-rag voyage-ai ai-coding vibe-coding claude-code Resources Readme License MIT license Contributing Contributing Activity Custom properties Stars 6.8k stars Watchers 37 watching Forks 580 forks Report repository Releases 23 tags Packages No packages published Contributors 17 @zc277584121 @Shawnzheng011019 @codingjaguar @jaxkodex @Acren @Froredion @fuleinist @BeamNawapat @janaki-sasidhar @viborc @Poojan-patel @KartDriver @LucasDeutsch11

• 3 contributors Languages TypeScript 69.2%

Python 15.4%

JavaScript 10.5%

CSS 3.0%

HTML 1.9% Footer © 2026 GitHub, Inc. Footer navigation Terms Privacy Security Status Community Docs Contact Manage cookies Do not share my personal information

https://github.com/zilliztech/claude-context