Improve the mcp setup instructions

Signed-off-by: codingjaguar <jiang.chen@zilliz.com>

Author: codingjaguar

README.md

@@ -9,52 +9,56 @@
 [![DeepWiki](https://img.shields.io/badge/DeepWiki-AI%20Docs-purple.svg?logo=gitbook&logoColor=white)](https://deepwiki.com/zilliztech/code-context)
 <a href="https://discord.gg/mKc3R95yE5"><img height="20" src="https://img.shields.io/badge/Discord-%235865F2.svg?style=for-the-badge&logo=discord&logoColor=white" alt="discord" /></a>
 
-**Code Context** is an MCP plugin for semantic code search for Claude Code, Gemini CLI, or Cursor. It adds semantic search and code analysis, providing improved context awareness in code generation.
+**Code Context** is an MCP plugin that brings semantic code search to Claude Code, Gemini CLI, or any AI coding agent. By indexing your entire codebase, it gives your assistant deep context awareness for better code generation.
 
-This plugin allows your coding assistant to perform semantic searches on your codebase, enabling it to answer questions and generate code with a deeper understanding of the project's context. For example, you can ask *"Where are all the authentication checks?"* and the agent will find the relevant code snippets based on meaning, not just keyword matches.
+AI coding assistants like Claude Code are limited by their context window and can only see part of your codebase. Code Context uses semantic search with a scalable vector database Zilliz Cloud so your assistant can find and understand relevant code from your whole project using natural language, not just keywords. This gives your AI assistant real context awareness.
 
-- **Search code by meaning, not just keywords**—thanks to powerful embedding models and Zilliz Cloud vector database integration.
-- **Understand and navigate massive codebases** with semantic search, context-aware discovery, and AI-powered code writing.
-- **Accelerate your workflow** by combining the best of Gemini CLI's AI capabilities with deep, actionable code insights.
+---
 
-> *"Code Context is a tool for code comprehension, search, and development. Unlock the full potential of your codebase, no matter its size."*
+## 🚀 Use Code Context as MCP in Claude Code and others
 
----
+Model Context Protocol (MCP) allows you to integrate Code Context with your favorite AI coding assistants.
 
-## 🌟 Why Code Context?
+### Prerequisites
 
-In the era of AI-first development, codebases are growing faster than ever. Traditional tools can't keep up:
+<details>
+<summary><strong>Get a free vector database on Zilliz Cloud</strong></summary>
 
-- **Claude Code** or **Gemini CLI** lacked full context of the entire codebase. No LLM can fit millions of lines of code in context, and `grep` doesn't work unless you can remember all variable names.
-- **Code Context** provides semantic search, allowing you to find, understand, and reuse code using natural language rather than just `grep`. It offers true context awareness by understanding relationships, structure, and intent across your entire codebase.
-- **Powered by Zilliz Cloud**, you get blazing-fast, scalable vector search for all your code.
+Code Context needs a vector database. You can [sign up](https://cloud.zilliz.com/signup) on Zilliz Cloud to get a free Serverless cluster.
 
-**Code Context provides the essential connection between AI code generation and understanding a codebase.**
+After creating your cluster, open your Zilliz Cloud console and copy both the **public endpoint** and your **API key**.  
+These will be used as `your-zilliz-cloud-public-endpoint` and `your-zilliz-cloud-api-key` in the configuration examples.
 
----
+![Zilliz Cloud Dashboard](assets/zilliz_cloud_dashboard.jpeg)
 
-## 🚀 Quick Start: MCP Integration
+Keep both values handy for the configuration steps below.
 
-Model Context Protocol (MCP) allows you to integrate Code Context with your favorite AI coding assistants.
+If you need help creating your free vector database or finding these values, see the [Zilliz Cloud documentation](https://docs.zilliz.com/docs/create-cluster) for detailed instructions.
 
-### Prerequisites
+</details>
+
+<details>
+<summary><strong>Get OpenAI API Key for embedding model</strong></summary>
+
+You need an OpenAI API key for the embedding model. You can get one by signing up at [OpenAI](https://platform.openai.com/api-keys).  
 
-- Node.js >= 20.0.0
-- pnpm >= 10.0.0
-- (Optional) Milvus database
-- (Optional) API key for OpenAI, VoyageAI, or other embedding providers.
+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`.
+
+</details>
+
+### Configure MCP for your AI Assistant
 
-### Environment Variables (Optional)
+#### Claude Code
 
-If you want to use cloud embedding/vector DBs:
+Use the command line interface to add the Code Context MCP server:
 
 ```bash
-OPENAI_API_KEY=your-openai-api-key
-MILVUS_ADDRESS=your-milvus-endpoint
-MILVUS_TOKEN=your-milvus-token
+# Add the Code Context MCP server
+claude mcp add code-context -e OPENAI_API_KEY=your-openai-api-key -e MILVUS_ADDRESS=your-zilliz-cloud-public-endpoint -e MILVUS_TOKEN=your-zilliz-cloud-api-key -- npx @zilliz/code-context-mcp@latest
 ```
 
-### Configure MCP for your AI Assistant
+See the [Claude Code MCP documentation](https://docs.anthropic.com/en/docs/claude-code/mcp) for more details about MCP server management.
 
 #### Gemini CLI
 
@@ -71,27 +75,16 @@ Gemini CLI requires manual configuration through a JSON file:
       "args": ["@zilliz/code-context-mcp@latest"],
       "env": {
         "OPENAI_API_KEY": "your-openai-api-key",
-        "MILVUS_ADDRESS": "localhost:19530"
+        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
+        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
       }
     }
   }
 }
 ```
 3. Save the file and restart Gemini CLI to apply the changes.
 
-#### Claude Code
-
-Use the command line interface to add the Code Context MCP server:
-
-```bash
-# Add the Code Context MCP server
-claude mcp add code-context -e OPENAI_API_KEY=your-openai-api-key -e MILVUS_ADDRESS=localhost:19530 -- npx @zilliz/code-context-mcp@latest
-```
-
-See the [Claude Code MCP documentation](https://docs.anthropic.com/en/docs/claude-code/mcp) for more details about MCP server management.
-
-<details>
-<summary><strong>Other MCP Client Configurations (Cursor, Windsurf, etc.)</strong></summary>
+### Other MCP Client Configurations (Cursor, Windsurf, etc.)
 
 <details>
 <summary><strong>Cursor</strong></summary>
@@ -110,8 +103,8 @@ Pasting the following configuration into your Cursor `~/.cursor/mcp.json` file i
       "args": ["-y", "@zilliz/code-context-mcp@latest"],
       "env": {
         "OPENAI_API_KEY": "your-openai-api-key",
-        "OPENAI_BASE_URL": "https://your-custom-endpoint.com/v1",
-        "MILVUS_ADDRESS": "localhost:19530"
+        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
+        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
       }
     }
   }
@@ -133,8 +126,8 @@ Add to your Claude Desktop configuration:
       "args": ["@zilliz/code-context-mcp@latest"],
       "env": {
         "OPENAI_API_KEY": "your-openai-api-key",
-        "OPENAI_BASE_URL": "https://your-custom-endpoint.com/v1",
-        "MILVUS_ADDRESS": "localhost:19530"
+        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
+        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
       }
     }
   }
@@ -156,8 +149,8 @@ Windsurf supports MCP configuration through a JSON file. Add the following confi
       "args": ["-y", "@zilliz/code-context-mcp@latest"],
       "env": {
         "OPENAI_API_KEY": "your-openai-api-key",
-        "OPENAI_BASE_URL": "https://your-custom-endpoint.com/v1",
-        "MILVUS_ADDRESS": "localhost:19530"
+        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
+        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
       }
     }
   }
@@ -179,8 +172,8 @@ The Code Context MCP server can be used with VS Code through MCP-compatible exte
       "args": ["-y", "@zilliz/code-context-mcp@latest"],
       "env": {
         "OPENAI_API_KEY": "your-openai-api-key",
-        "OPENAI_BASE_URL": "https://your-custom-endpoint.com/v1",
-        "MILVUS_ADDRESS": "localhost:19530"
+        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
+        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
       }
     }
   }
@@ -202,8 +195,8 @@ Cherry Studio allows for visual MCP server configuration through its settings in
    - **Arguments**: `["@zilliz/code-context-mcp@latest"]`
    - **Environment Variables**:
      - `OPENAI_API_KEY`: `your-openai-api-key`
-     - `OPENAI_BASE_URL`: `https://your-custom-endpoint.com/v1` (optional)
-     - `MILVUS_ADDRESS`: `localhost:19530`
+     - `MILVUS_ADDRESS`: `your-zilliz-cloud-public-endpoint`
+     - `MILVUS_TOKEN`: `your-zilliz-cloud-api-key`
 3. Save the configuration to activate the server.
 
 </details>
@@ -227,8 +220,8 @@ Cline uses a JSON configuration file to manage MCP servers. To integrate the pro
       "args": ["@zilliz/code-context-mcp@latest"],
       "env": {
         "OPENAI_API_KEY": "your-openai-api-key",
-        "OPENAI_BASE_URL": "https://your-custom-endpoint.com/v1",
-        "MILVUS_ADDRESS": "localhost:19530"
+        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
+        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
       }
     }
   }
@@ -282,8 +275,8 @@ To configure Code Context MCP in Augment Code, you can use either the graphical
       "args": ["-y", "@zilliz/code-context-mcp@latest"],
       "env": {
         "OPENAI_API_KEY": "your-openai-api-key",
-        "OPENAI_BASE_URL": "https://your-custom-endpoint.com/v1",
-        "MILVUS_ADDRESS": "localhost:19530"
+        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
+        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
       }
     }
   ]
@@ -309,8 +302,8 @@ Roo Code utilizes a JSON configuration file for MCP servers:
       "args": ["@zilliz/code-context-mcp@latest"],
       "env": {
         "OPENAI_API_KEY": "your-openai-api-key",
-        "OPENAI_BASE_URL": "https://your-custom-endpoint.com/v1",
-        "MILVUS_ADDRESS": "localhost:19530"
+        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
+        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
       }
     }
   }
@@ -340,15 +333,13 @@ npx @zilliz/code-context-mcp@latest
 ## ✨ Features
 
 - 🔍 **Semantic Code Search**: Ask questions like *"find functions that handle user authentication"* and get relevant, context-rich code instantly.
--  **Context-Aware Discovery**: Understand how different parts of your codebase relate, even across millions of lines.
--  **AI-Assisted Programming**: Generate, refactor, or extend code using natural language prompts.
--  **Local & Cloud Indexing**: Index your codebase locally or leverage Zilliz Cloud for scalable, privacy-respecting search.
+- 🧠 **Context-Aware Discovery**: Understand how different parts of your codebase relate, even across millions of lines.
+- 🤖 **AI-Assisted Programming**: Generate, refactor, or extend code using natural language prompts.
 - ⚡ **Incremental File Synchronization**: Efficiently re-index only changed files using Merkle trees.
--  **Smart Chunking**: AST-based code splitting for context-preserving search and generation.
--  **Productivity**: Reduce time spent searching and writing boilerplate code—focus on what matters.
--  **Pluggable Embedding Providers**: Support for OpenAI, VoyageAI, Ollama, and more.
--  **Vector Storage**: Integrates with Zilliz Cloud for scalable vector search, no matter how large your codebase is.
--  **Customizable**: Configure file extensions, ignore patterns, and embedding models.
+- 🧩 **Smart Chunking**: AST-based code splitting for context-preserving search and generation.
+- 🔌 **Pluggable Embedding Providers**: Support for OpenAI, VoyageAI, Ollama, and more.
+- 🗄️ **Vector Storage**: Integrates with Zilliz Cloud for scalable vector search, no matter how large your codebase is.
+- 🛠️ **Customizable**: Configure file extensions, ignore patterns, and embedding models.
 
 ---
 
@@ -391,8 +382,8 @@ const embedding = new OpenAIEmbedding({
 
 // Initialize vector database
 const vectorDatabase = new MilvusVectorDatabase({
-    address: process.env.MILVUS_ADDRESS || 'localhost:19530',
-    token: process.env.MILVUS_TOKEN || ''
+    address: process.env.MILVUS_ADDRESS || 'your-zilliz-cloud-public-endpoint',
+    token: process.env.MILVUS_TOKEN || 'your-zilliz-cloud-api-key'
 });
 
 // Create indexer instance