danielbowne/claude-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 locally in a vector database and only uses related code in context to keep your costs manageable.
🏠 Local-First with LanceDB: By default, Claude Context uses LanceDB for local, embedded vector storage - no external services required. Quick setup with your data staying on your machine.
## 🚀 Demo
Model Context Protocol (MCP) allows you to integrate Claude Context with your favorite AI coding assistants, e.g. Claude Code.
## 🚀 Quick Start
Setup in 30 seconds - Just one command!
### Step 1: Get your OpenAI API Key
Get a free API key from OpenAI (starts with sk-)
### Step 2: Add to Claude Code
bash
claude mcp add claude-context -e OPENAIAPIKEY=your-openai-api-key -- npx @dannyboy2042/claude-context-mcp@latest
That's it! 🎉 Claude Context will:
✅ Install automatically with no setup required
✅ Store everything locally using LanceDB (no cloud services needed)
✅ Work with any codebase size
✅ Enable hybrid vector + text search for better results
### Step 3: Start using it
1. Open Claude Code in your project directory
2. Ask Claude to "index this codebase"
3. Then ask questions like "find the authentication logic" or "show me the database connection code"
### 📁 Multiple Projects Support
Claude Context automatically handles multiple projects by creating isolated collections for each codebase:
Each project gets its own collection based on the project's absolute path
Projects are completely isolated from each other
Switch between projects by opening Claude Code in different directories
All data stored locally in ~/.claude-context/lancedb/
System Requirements:
Node.js >= 20.0.0 (Claude Context works locally - no external services required!)
See the Claude Code MCP documentation for more details.
### Other MCP Client Configurations
Simple setup for any MCP client - just add your OpenAI API key!
Gemini CLI
Create or edit the ~/.gemini/settings.json file:
json
"mcpServers": {
"claude-context": {
"command": "npx",
"args": ["@dannyboy2042/claude-context-mcp@latest"],
"env": {
"OPENAIAPIKEY": "your-openai-api-key"
Qwen Code
Create or edit the ~/.qwen/settings.json file:
json
"mcpServers": {
"claude-context": {
"command": "npx",
"args": ["@dannyboy2042/claude-context-mcp@latest"],
"env": {
"OPENAIAPIKEY": "your-openai-api-key"
Cursor
Go to: Settings -> Cursor Settings -> MCP -> Add new global MCP server
Add this to your Cursor ~/.cursor/mcp.json file:
json
"mcpServers": {
"claude-context": {
"command": "npx",
"args": ["-y", "@dannyboy2042/claude-context-mcp@latest"],
"env": {
"OPENAIAPIKEY": "your-openai-api-key"
Void
Go to: Settings -> MCP -> Add MCP Server
Add the following configuration to your Void MCP settings: