[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-10140":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":47,"readmeContent":48,"aiSummary":49,"trendingCount":16,"starSnapshotCount":16,"syncStatus":50,"lastSyncTime":51,"discoverSource":52},10140,"claude-context","zilliztech\u002Fclaude-context","zilliztech","Code search MCP for Claude Code. Make entire codebase the context for any coding agent.","https:\u002F\u002Fgithub.com\u002Fzilliztech\u002Fclaude-context\u002Ftree\u002Fmaster\u002Fdocs",null,"TypeScript",11816,869,51,70,0,6,110,861,34,43.82,"MIT License",false,"master",true,[27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46],"agent","agentic-rag","ai-coding","claude-code","code-generation","code-search","cursor","embedding","gemini-cli","mcp","merkle-tree","nodejs","openai","rag","semantic-search","typescript","vector-database","vibe-coding","voyage-ai","vscode-extension","2026-06-12 02:02:17","![](assets\u002Fclaude-context.png)\n\n> 🆕 **Looking for persistent memory for Claude Code?** Check out [memsearch Claude Code plugin](https:\u002F\u002Fgithub.com\u002Fzilliztech\u002Fmemsearch#for-claude-code-users) — a markdown-first memory system that gives your AI agent long-term memory across sessions.\n\n### Your entire codebase as Claude's context\n\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-blue.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n[![Node.js](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FNode.js-20%2B-green.svg)](https:\u002F\u002Fnodejs.org\u002F)\n[![Documentation](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDocumentation-📚-orange.svg)](docs\u002F)\n[![VS Code Marketplace](https:\u002F\u002Fimg.shields.io\u002Fvisual-studio-marketplace\u002Fv\u002Fzilliz.semanticcodesearch?label=VS%20Code%20Extension&logo=visual-studio-code)](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=zilliz.semanticcodesearch)\n[![npm - core](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@zilliz\u002Fclaude-context-core?label=%40zilliz%2Fclaude-context-core&logo=npm)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@zilliz\u002Fclaude-context-core)\n[![npm - mcp](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@zilliz\u002Fclaude-context-mcp?label=%40zilliz%2Fclaude-context-mcp&logo=npm)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@zilliz\u002Fclaude-context-mcp)\n[![Twitter](https:\u002F\u002Fimg.shields.io\u002Ftwitter\u002Furl\u002Fhttps\u002Ftwitter.com\u002Fzilliz_universe.svg?style=social&label=Follow%20%40Zilliz)](https:\u002F\u002Ftwitter.com\u002Fzilliz_universe)\n[![DeepWiki](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDeepWiki-AI%20Docs-purple.svg?logo=gitbook&logoColor=white)](https:\u002F\u002Fdeepwiki.com\u002Fzilliztech\u002Fclaude-context)\n\u003Ca href=\"https:\u002F\u002Fdiscord.gg\u002FmKc3R95yE5\">\u003Cimg height=\"20\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-%235865F2.svg?style=for-the-badge&logo=discord&logoColor=white\" alt=\"discord\" \u002F>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Ftrendshift.io\u002Frepositories\u002F15064\">\u003Cimg src=\"https:\u002F\u002Ftrendshift.io\u002Fapi\u002Fbadge\u002Frepositories\u002F15064\" alt=\"zilliztech\u002Fclaude-context | Trendshift\" width=\"250\" height=\"55\" \u002F>\u003C\u002Fa>\n\u003C\u002Fdiv>\n\n**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.\n\n🧠 **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.\n\n💰 **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.\n\n---\n\n## 🚀 Demo\n\n![img](https:\u002F\u002Flh7-rt.googleusercontent.com\u002Fdocsz\u002FAD_4nXf2uIf2c5zowp-iOMOqsefHbY_EwNGiutkxtNXcZVJ8RI6SN9DsCcsc3amXIhOZx9VcKFJQLSAqM-2pjU9zoGs1r8GCTUL3JIsLpLUGAm1VQd5F2o5vpEajx2qrc77iXhBu1zWj?key=qYdFquJrLcfXCUndY-YRBQ)\n\nModel Context Protocol (MCP) allows you to integrate Claude Context with your favorite AI coding assistants, e.g. Claude Code.\n\n## Quick Start\n\n### Prerequisites\n\n\u003Cdetails>\n\u003Csummary>Get a free vector database on Zilliz Cloud 👈\u003C\u002Fsummary>\n\nClaude Context needs a vector database. You can [sign up](https:\u002F\u002Fcloud.zilliz.com\u002Fsignup?utm_source=github&utm_medium=referral&utm_campaign=2507-codecontext-readme) on Zilliz Cloud to get an API key.\n\n![](assets\u002Fsignup_and_get_apikey.png)\n\nCopy your Personal Key to replace `your-zilliz-cloud-api-key` in the configuration examples.\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>Get OpenAI API Key for embedding model\u003C\u002Fsummary>\n\nYou need an OpenAI API key for the embedding model. You can get one by signing up at [OpenAI](https:\u002F\u002Fplatform.openai.com\u002Fapi-keys).  \n\nYour API key will look like this: it always starts with `sk-`.  \nCopy your key and use it in the configuration examples below as `your-openai-api-key`.\n\n\u003C\u002Fdetails>\n\n### Configure MCP for Claude Code\n\n**System Requirements:**\n\n- Node.js >= 20.0.0\n\n#### Configuration\n\nUse the command line interface to add the Claude Context MCP server:\n\n```bash\nclaude mcp add claude-context \\\n  -e OPENAI_API_KEY=sk-your-openai-api-key \\\n  -e MILVUS_ADDRESS=your-zilliz-cloud-public-endpoint \\\n  -e MILVUS_TOKEN=your-zilliz-cloud-api-key \\\n  -- npx @zilliz\u002Fclaude-context-mcp@latest\n```\n\nSee the [Claude Code MCP documentation](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fmcp) for more details about MCP server management.\n\n### Other MCP Client Configurations\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>OpenAI Codex CLI\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nCodex CLI uses TOML configuration files:\n\n1. Create or edit the `~\u002F.codex\u002Fconfig.toml` file.\n\n2. Add the following configuration:\n\n```toml\n# IMPORTANT: the top-level key is `mcp_servers` rather than `mcpServers`.\n[mcp_servers.claude-context]\ncommand = \"npx\"\nargs = [\"@zilliz\u002Fclaude-context-mcp@latest\"]\nenv = { \"OPENAI_API_KEY\" = \"your-openai-api-key\", \"MILVUS_TOKEN\" = \"your-zilliz-cloud-api-key\" }\n# Optional: override the default 10s startup timeout\nstartup_timeout_ms = 20000\n```\n\n3. Save the file and restart Codex CLI to apply the changes.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Gemini CLI\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nGemini CLI requires manual configuration through a JSON file:\n\n1. Create or edit the `~\u002F.gemini\u002Fsettings.json` file.\n2. Add the following configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"claude-context\": {\n      \"command\": \"npx\",\n      \"args\": [\"@zilliz\u002Fclaude-context-mcp@latest\"],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"your-openai-api-key\",\n        \"MILVUS_TOKEN\": \"your-zilliz-cloud-api-key\"\n      }\n    }\n  }\n}\n```\n\n3. Save the file and restart Gemini CLI to apply the changes.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Qwen Code\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nCreate or edit the `~\u002F.qwen\u002Fsettings.json` file and add the following configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"claude-context\": {\n      \"command\": \"npx\",\n      \"args\": [\"@zilliz\u002Fclaude-context-mcp@latest\"],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"your-openai-api-key\",\n        \"MILVUS_ADDRESS\": \"your-zilliz-cloud-public-endpoint\",\n        \"MILVUS_TOKEN\": \"your-zilliz-cloud-api-key\"\n      }\n    }\n  }\n}\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Cursor\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nGo to: `Settings` -> `Cursor Settings` -> `MCP` -> `Add new global MCP server`\n\nPasting the following configuration into your Cursor `~\u002F.cursor\u002Fmcp.json` file is the recommended approach. You may also install in a specific project by creating `.cursor\u002Fmcp.json` in your project folder. See [Cursor MCP docs](https:\u002F\u002Fcursor.com\u002Fdocs\u002Fcontext\u002Fmcp) for more info.\n\n```json\n{\n  \"mcpServers\": {\n    \"claude-context\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@zilliz\u002Fclaude-context-mcp@latest\"],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"your-openai-api-key\",\n        \"MILVUS_ADDRESS\": \"your-zilliz-cloud-public-endpoint\",\n        \"MILVUS_TOKEN\": \"your-zilliz-cloud-api-key\"\n      }\n    }\n  }\n}\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Void\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nGo to: `Settings` -> `MCP` -> `Add MCP Server`\n\nAdd the following configuration to your Void MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"code-context\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@zilliz\u002Fclaude-context-mcp@latest\"],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"your-openai-api-key\",\n        \"MILVUS_ADDRESS\": \"your-zilliz-cloud-public-endpoint\",\n        \"MILVUS_TOKEN\": \"your-zilliz-cloud-api-key\"\n      }\n    }\n  }\n}\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Claude Desktop\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nAdd to your Claude Desktop configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"claude-context\": {\n      \"command\": \"npx\",\n      \"args\": [\"@zilliz\u002Fclaude-context-mcp@latest\"],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"your-openai-api-key\",\n        \"MILVUS_ADDRESS\": \"your-zilliz-cloud-public-endpoint\",\n        \"MILVUS_TOKEN\": \"your-zilliz-cloud-api-key\"\n      }\n    }\n  }\n}\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Windsurf\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nWindsurf supports MCP configuration through a JSON file. Add the following configuration to your Windsurf MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"claude-context\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@zilliz\u002Fclaude-context-mcp@latest\"],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"your-openai-api-key\",\n        \"MILVUS_ADDRESS\": \"your-zilliz-cloud-public-endpoint\",\n        \"MILVUS_TOKEN\": \"your-zilliz-cloud-api-key\"\n      }\n    }\n  }\n}\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>VS Code\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nThe Claude Context MCP server can be used with VS Code through MCP-compatible extensions. Add the following configuration to your VS Code MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"claude-context\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@zilliz\u002Fclaude-context-mcp@latest\"],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"your-openai-api-key\",\n        \"MILVUS_ADDRESS\": \"your-zilliz-cloud-public-endpoint\",\n        \"MILVUS_TOKEN\": \"your-zilliz-cloud-api-key\"\n      }\n    }\n  }\n}\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Cherry Studio\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nCherry Studio allows for visual MCP server configuration through its settings interface. While it doesn't directly support manual JSON configuration, you can add a new server via the GUI:\n\n1. Navigate to **Settings → MCP Servers → Add Server**.\n2. Fill in the server details:\n   - **Name**: `claude-context`\n   - **Type**: `STDIO`\n   - **Command**: `npx`\n   - **Arguments**: `[\"-y\", \"@zilliz\u002Fclaude-context-mcp@latest\"]`\n   - **Environment Variables**:\n     - `OPENAI_API_KEY`: `your-openai-api-key`\n     - `MILVUS_ADDRESS`: `your-zilliz-cloud-public-endpoint`\n     - `MILVUS_TOKEN`: `your-zilliz-cloud-api-key`\n3. Save the configuration to activate the server.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Cline\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nCline uses a JSON configuration file to manage MCP servers. To integrate the provided MCP server configuration:\n\n1. Open Cline and click on the **MCP Servers** icon in the top navigation bar.\n\n2. Select the **Installed** tab, then click **Advanced MCP Settings**.\n\n3. In the `cline_mcp_settings.json` file, add the following configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"claude-context\": {\n      \"command\": \"npx\",\n      \"args\": [\"@zilliz\u002Fclaude-context-mcp@latest\"],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"your-openai-api-key\",\n        \"MILVUS_ADDRESS\": \"your-zilliz-cloud-public-endpoint\",\n        \"MILVUS_TOKEN\": \"your-zilliz-cloud-api-key\"\n      }\n    }\n  }\n}\n```\n\n4. Save the file.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Augment\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nTo configure Claude Context MCP in Augment Code, you can use either the graphical interface or manual configuration.\n\n#### **A. Using the Augment Code UI**\n\n1. Click the hamburger menu.\n\n2. Select **Settings**.\n\n3. Navigate to the **Tools** section.\n\n4. Click the **+ Add MCP** button.\n\n5. Enter the following command:\n\n   ```\n   npx @zilliz\u002Fclaude-context-mcp@latest\n   ```\n\n6. Name the MCP: **Claude Context**.\n\n7. Click the **Add** button.\n\n------\n\n#### **B. Manual Configuration**\n\n1. Press Cmd\u002FCtrl Shift P or go to the hamburger menu in the Augment panel\n2. Select Edit Settings\n3. Under Advanced, click Edit in settings.json\n4. Add the server configuration to the `mcpServers` array in the `augment.advanced` object\n\n```json\n\"augment.advanced\": { \n  \"mcpServers\": [ \n    { \n      \"name\": \"claude-context\", \n      \"command\": \"npx\", \n      \"args\": [\"-y\", \"@zilliz\u002Fclaude-context-mcp@latest\"],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"your-openai-api-key\",\n        \"MILVUS_ADDRESS\": \"your-zilliz-cloud-public-endpoint\",\n        \"MILVUS_TOKEN\": \"your-zilliz-cloud-api-key\"\n      }\n    }\n  ]\n}\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Roo Code\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nRoo Code utilizes a JSON configuration file for MCP servers:\n\n1. Open Roo Code and navigate to **Settings → MCP Servers → Edit Global Config**.\n\n2. In the `mcp_settings.json` file, add the following configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"claude-context\": {\n      \"command\": \"npx\",\n      \"args\": [\"@zilliz\u002Fclaude-context-mcp@latest\"],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"your-openai-api-key\",\n        \"MILVUS_ADDRESS\": \"your-zilliz-cloud-public-endpoint\",\n        \"MILVUS_TOKEN\": \"your-zilliz-cloud-api-key\"\n      }\n    }\n  }\n}\n```\n\n3. Save the file to activate the server.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Zencoder\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nZencoder offers support for MCP tools and servers in both its JetBrains and VS Code plugin versions.\n\n1. Go to the Zencoder menu (...)\n2. From the dropdown menu, select `Tools`\n3. Click on the `Add Custom MCP`\n4. Add the name (i.e. `Claude Context` and server configuration from below, and make sure to hit the `Install` button\n\n```json\n{\n    \"command\": \"npx\",\n    \"args\": [\"@zilliz\u002Fclaude-context-mcp@latest\"],\n    \"env\": {\n      \"OPENAI_API_KEY\": \"your-openai-api-key\",\n      \"MILVUS_ADDRESS\": \"your-zilliz-cloud-public-endpoint\",\n      \"MILVUS_TOKEN\": \"your-zilliz-cloud-api-key\"\n    }\n}\n\n```\n\n5. Save the server by hitting the `Install` button.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>LangChain\u002FLangGraph\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nFor LangChain\u002FLangGraph integration examples, see [this example](https:\u002F\u002Fgithub.com\u002Fzilliztech\u002Fclaude-context\u002Fblob\u002F643796a0d30e706a2a0dff3d55621c9b5d831807\u002Fevaluation\u002Fretrieval\u002Fcustom.py#L88).\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Other MCP Clients\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nThe server uses stdio transport and follows the standard MCP protocol. It can be integrated with any MCP-compatible client by running:\n\n```bash\nnpx @zilliz\u002Fclaude-context-mcp@latest\n```\n\n\u003C\u002Fdetails>\n\n---\n\n### Usage in Your Codebase\n\n1. **Open Claude Code**\n\n   ```\n   cd your-project-directory\n   claude\n   ```\n\n2. **Index your codebase**:\n\n   ```\n   Index this codebase\n   ```\n\n3. **Check indexing status**:\n\n   ```\n   Check the indexing status\n   ```\n\n4. **Start searching**:\n\n   ```\n   Find functions that handle user authentication\n   ```\n\n🎉 **That's it!** You now have semantic code search in Claude Code.\n\n---\n\n### Environment Variables Configuration\n\nFor more detailed MCP environment variable configuration, see our [Environment Variables Guide](docs\u002Fgetting-started\u002Fenvironment-variables.md).\n\n### Using Different Embedding Models\n\nTo configure custom embedding models (e.g., `text-embedding-3-large` for OpenAI, `voyage-code-3` for VoyageAI), see the [MCP Configuration Examples](packages\u002Fmcp\u002FREADME.md#embedding-provider-configuration) for detailed setup instructions for each provider.\n\n### File Inclusion & Exclusion Rules\n\nFor detailed explanation of file inclusion and exclusion rules, and how to customize them, see our [File Inclusion & Exclusion Rules](docs\u002Fdive-deep\u002Ffile-inclusion-rules.md).\n\n### Available Tools\n\n#### 1. `index_codebase`\n\nIndex a codebase directory for hybrid search (BM25 + dense vector).\n\n#### 2. `search_code`\n\nSearch the indexed codebase using natural language queries with hybrid search (BM25 + dense vector).\n\n#### 3. `clear_index`\n\nClear the search index for a specific codebase.\n\n#### 4. `get_indexing_status`\n\nGet the current indexing status of a codebase. Shows progress percentage for actively indexing codebases and completion status for indexed codebases.\n\n---\n\n## 📊 Evaluation\n\nOur 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.\n\n![MCP Efficiency Analysis](assets\u002Fmcp_efficiency_analysis_chart.png)\n\nFor detailed evaluation methodology and results, see the [evaluation directory](evaluation\u002F).\n\n---\n\n## 🏗️ Architecture\n\n![](assets\u002FArchitecture.png)\n\n### 🔧 Implementation Details\n\n- 🔍 **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).\n- 🧠 **Context-Aware**: Discover large codebase, understand how different parts of your codebase relate, even across millions of lines of code.\n- ⚡ **Incremental Indexing**: Efficiently re-index only changed files using Merkle trees.\n- 🧩 **Intelligent Code Chunking**: Analyze code in Abstract Syntax Trees (AST) for chunking.\n- 🗄️ **Scalable**: Integrates with Zilliz Cloud for scalable vector search, no matter how large your codebase is.\n- 🛠️ **Customizable**: Configure file extensions, ignore patterns, and embedding models.\n\n### Core Components\n\nClaude Context is a monorepo containing three main packages:\n\n- **`@zilliz\u002Fclaude-context-core`**: Core indexing engine with embedding and vector database integration\n- **VSCode Extension**: Semantic Code Search extension for Visual Studio Code\n- **`@zilliz\u002Fclaude-context-mcp`**: Model Context Protocol server for AI agent integration\n\n### Supported Technologies\n\n- **Embedding Providers**: [OpenAI](https:\u002F\u002Fopenai.com), [VoyageAI](https:\u002F\u002Fvoyageai.com), [Ollama](https:\u002F\u002Follama.com), [Gemini](https:\u002F\u002Fgemini.google.com)\n- **Vector Databases**: [Milvus](https:\u002F\u002Fmilvus.io) or [Zilliz Cloud](https:\u002F\u002Fzilliz.com\u002Fcloud)(fully managed vector database as a service)\n- **Code Splitters**: AST-based splitter (with automatic fallback), LangChain character-based splitter\n- **Languages**: TypeScript, JavaScript, Python, Java, C++, C#, Go, Rust, PHP, Ruby, Swift, Kotlin, Scala, Markdown\n- **Development Tools**: VSCode, Model Context Protocol\n\n---\n\n## 📦 Other Ways to Use Claude Context\n\nWhile MCP is the recommended way to use Claude Context with AI assistants, you can also use it directly or through the VSCode extension.\n\n### Build Applications with Core Package\n\nThe `@zilliz\u002Fclaude-context-core` package provides the fundamental functionality for code indexing and semantic search.\n\n```typescript\nimport { Context, MilvusVectorDatabase, OpenAIEmbedding } from '@zilliz\u002Fclaude-context-core';\n\n\u002F\u002F Initialize embedding provider\nconst embedding = new OpenAIEmbedding({\n    apiKey: process.env.OPENAI_API_KEY || 'your-openai-api-key',\n    model: 'text-embedding-3-small'\n});\n\n\u002F\u002F Initialize vector database\nconst vectorDatabase = new MilvusVectorDatabase({\n    address: process.env.MILVUS_ADDRESS || 'your-zilliz-cloud-public-endpoint',\n    token: process.env.MILVUS_TOKEN || 'your-zilliz-cloud-api-key'\n});\n\n\u002F\u002F Create context instance\nconst context = new Context({\n    embedding,\n    vectorDatabase\n});\n\n\u002F\u002F Index your codebase with progress tracking\nconst stats = await context.indexCodebase('.\u002Fyour-project', (progress) => {\n    console.log(`${progress.phase} - ${progress.percentage}%`);\n});\nconsole.log(`Indexed ${stats.indexedFiles} files, ${stats.totalChunks} chunks`);\n\n\u002F\u002F Perform semantic search\nconst results = await context.semanticSearch('.\u002Fyour-project', 'vector database operations', 5);\nresults.forEach(result => {\n    console.log(`File: ${result.relativePath}:${result.startLine}-${result.endLine}`);\n    console.log(`Score: ${(result.score * 100).toFixed(2)}%`);\n    console.log(`Content: ${result.content.substring(0, 100)}...`);\n});\n```\n\n### VSCode Extension\n\nIntegrates Claude Context directly into your IDE. Provides an intuitive interface for semantic code search and navigation.\n\n1. **Direct Link**: [Install from VS Code Marketplace](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=zilliz.semanticcodesearch)\n2. **Manual Search**:\n    - Open Extensions view in VSCode (Ctrl+Shift+X or Cmd+Shift+X on Mac)\n    - Search for \"Semantic Code Search\"\n    - Click Install\n\n![img](https:\u002F\u002Flh7-rt.googleusercontent.com\u002Fdocsz\u002FAD_4nXdtCtT9Qi6o5mGVoxzX50r8Nb6zDFcjvTQR7WZ-xMbEsHEPPhSYAFVJ7q4-rETzxJ8wy1cyZmU8CmtpNhAU8PGOqVnE2kc2HCn1etDg97Qsh7m89kBjG4ZT7XBgO4Dp7BfFZx7eow?key=qYdFquJrLcfXCUndY-YRBQ)\n---\n\n## 🛠️ Development\n\n### Setup Development Environment\n\n#### Prerequisites\n\n- Node.js 20.x, 22.x, or 24.x\n- pnpm (recommended package manager)\n\n#### Cross-Platform Setup\n\n```bash\n# Clone repository\ngit clone https:\u002F\u002Fgithub.com\u002Fzilliztech\u002Fclaude-context.git\ncd claude-context\n\n# Install dependencies\npnpm install\n\n# Build all packages\npnpm build\n\n# Start development mode\npnpm dev\n```\n\n#### Windows-Specific Setup\n\nOn Windows, ensure you have:\n\n- **Git for Windows** with proper line ending configuration\n- **Node.js** installed via the official installer or package manager\n- **pnpm** installed globally: `npm install -g pnpm`\n\n```powershell\n# Windows PowerShell\u002FCommand Prompt\ngit clone https:\u002F\u002Fgithub.com\u002Fzilliztech\u002Fclaude-context.git\ncd claude-context\n\n# Configure git line endings (recommended)\ngit config core.autocrlf false\n\n# Install dependencies\npnpm install\n\n# Build all packages (uses cross-platform scripts)\npnpm build\n\n# Start development mode\npnpm dev\n```\n\n### Building\n\n```bash\n# Build all packages (cross-platform)\npnpm build\n\n# Build specific package\npnpm build:core\npnpm build:vscode\npnpm build:mcp\n\n# Performance benchmarking\npnpm benchmark\n```\n\n#### Windows Build Notes\n\n- All build scripts are cross-platform compatible using rimraf\n- Build caching is enabled for faster subsequent builds\n- Use PowerShell or Command Prompt - both work equally well\n\n### Running Examples\n\n```bash\n# Development with file watching\ncd examples\u002Fbasic-usage\npnpm dev\n```\n\n---\n\n## 📖 Examples\n\nCheck the `\u002Fexamples` directory for complete usage examples:\n\n- **Basic Usage**: Simple indexing and search example\n\n---\n\n## ❓ FAQ\n\n**Common Questions:**\n\n- **[What files does Claude Context decide to embed?](docs\u002Ftroubleshooting\u002Ffaq.md#q-what-files-does-claude-context-decide-to-embed)**\n- **[Can I use a fully local deployment setup?](docs\u002Ftroubleshooting\u002Ffaq.md#q-can-i-use-a-fully-local-deployment-setup)**\n- **[Does it support multiple projects \u002F codebases?](docs\u002Ftroubleshooting\u002Ffaq.md#q-does-it-support-multiple-projects--codebases)**\n- **[How does Claude Context compare to other coding tools?](docs\u002Ftroubleshooting\u002Ffaq.md#q-how-does-claude-context-compare-to-other-coding-tools-like-serena-context7-or-deepwiki)**\n\n❓ For detailed answers and more troubleshooting tips, see our [FAQ Guide](docs\u002Ftroubleshooting\u002Ffaq.md).\n\n🔧 **Encountering issues?** Visit our [Troubleshooting Guide](docs\u002Ftroubleshooting\u002Ftroubleshooting-guide.md) for step-by-step solutions.\n\n📚 **Need more help?** Check out our [complete documentation](docs\u002F) for detailed guides and troubleshooting tips.\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details on how to get started.\n\n**Package-specific contributing guides:**\n\n- [Core Package Contributing](packages\u002Fcore\u002FCONTRIBUTING.md)\n- [MCP Server Contributing](packages\u002Fmcp\u002FCONTRIBUTING.md)  \n- [VSCode Extension Contributing](packages\u002Fvscode-extension\u002FCONTRIBUTING.md)\n\n---\n\n## 🗺️ Roadmap\n\n- [x] AST-based code analysis for improved understanding\n- [x] Support for additional embedding providers\n- [ ] Agent-based interactive search mode\n- [x] Enhanced code chunking strategies\n- [ ] Search result ranking optimization\n- [ ] Robust Chrome Extension\n\n---\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## 🔗 Links\n\n- [GitHub Repository](https:\u002F\u002Fgithub.com\u002Fzilliztech\u002Fclaude-context)\n- [VSCode Marketplace](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=zilliz.semanticcodesearch)\n- [Milvus Documentation](https:\u002F\u002Fmilvus.io\u002Fdocs)\n- [Zilliz Cloud](https:\u002F\u002Fzilliz.com\u002Fcloud)\n","Claude Context 是一个为 Claude Code 及其他 AI 编码助手设计的 MCP 插件，它通过语义代码搜索技术使整个代码库成为编码代理的上下文。该项目利用向量数据库高效存储代码，并仅在需要时加载相关部分到 Claude 的上下文中，从而有效降低了处理大型代码库的成本。此外，Claude Context 支持直接从数百万行代码中找到最相关的片段，无需多轮探索即可提供精准结果。适用于需要对复杂或大规模项目进行智能代码搜索和理解的情景。",2,"2026-06-11 03:26:49","top_topic"]