返回市场
克劳德上下文

克劳德上下文

作者:zilliztech4534 星标更新:2025-09-16

项目介绍

【技术文档摘要】:

您整个代码库作为上下文

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

</div>

Claude Context 是一个MCP插件,它为Claude Code和其他AI编码代理添加了语义代码搜索功能,使它们能够从您的整个代码库中获得深度上下文。

🧠 您的整个代码库作为上下文:Claude Context 使用语义搜索来查找数百万行代码中的所有相关代码。无需多轮发现。它直接将结果带入Claude的上下文中。

💰 大型代码库的成本效益:无需在每次请求时都将整个目录加载到Claude中,这可能会非常昂贵。Claude Context 效率地将您的代码库存储在向量数据库中,并仅使用相关的代码来保持成本可控。


🚀 示例

img

模型上下文协议(MCP)允许您将Claude Context与您最喜欢的AI编码助手集成,例如Claude Code。

快速开始

先决条件

<details> <summary>在Zilliz Cloud上获取免费的向量数据库 👈</summary>

Claude Context 需要一个向量数据库。您可以在 Zilliz Cloud 上注册以获取API密钥。

复制您的个人密钥,替换配置示例中的 your-zilliz-cloud-api-key

</details> <details> <summary>获取用于嵌入模型的OpenAI API密钥</summary>

您需要一个OpenAI API密钥用于嵌入模型。您可以通过在 OpenAI 注册来获取一个。

您的API密钥看起来像这样:它总是以 sk- 开头。 复制您的密钥并在下面的配置示例中使用它作为 your-openai-api-key

</details>

为Claude Code配置MCP

系统需求:

  • Node.js >= 20.0.0 并且 < 24.0.0

注意:Claude Context 不兼容 Node.js 24.0.0,如果您的Node版本大于或等于24,请先降级。

配置

使用命令行界面添加Claude Context MCP服务器:

claude mcp add claude-context \
  -e OPENAI_API_KEY=sk-your-openai-api-key \
  -e MILVUS_TOKEN=your-zilliz-cloud-api-key \
  -- npx @zilliz/claude-context-mcp@latest

有关MCP服务器管理的更多详细信息,请参阅 Claude Code MCP文档

其他MCP客户端配置

<details> <summary><strong>OpenAI Codex CLI</strong></summary>

Codex CLI 使用 TOML 配置文件:

  1. 创建或编辑 ~/.codex/config.toml 文件。

  2. 添加以下配置:

# 重要提示:顶级键是 `mcp_servers` 而不是 `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" }
# 可选:覆盖默认的10秒启动超时时间
startup_timeout_ms = 20000
  1. 保存文件并重新启动 Codex CLI 以应用更改。
</details> <details> <summary><strong>Gemini CLI</strong></summary>

Gemini CLI 需要通过 JSON 文件进行手动配置:

  1. 创建或编辑 ~/.gemini/settings.json 文件。
  2. 添加以下配置:
{
  "mcpServers": {
    "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"
      }
    }
  }
}
  1. 保存文件并重新启动 Gemini CLI 以应用更改。
</details> <details> <summary><strong>Qwen Code</strong></summary>

创建或编辑 ~/.qwen/settings.json 文件并添加以下配置:

{
  "mcpServers": {
    "claude-context": {
      "command": "npx",
      "args": ["@zilliz/claude-context-mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
      }
    }
  }
}
</details> <details> <summary><strong>Cursor</strong></summary>

<a href="https://cursor.com/install-mcp?name=claude-context&config=JTdCJTIyY29tbWFuZCUyMiUzQSUyMm5weCUyMC15JTIwJTQwemlsbGl6JTJGY29kZS1jb250ZXh0LW1jcCU0MGxhdGVzdCUyMiUyQyUyMmVudiUyMiUzQSU3QiUyMk9QRU5BSV9BUElfS0VZJTIyJTNBJTIyeW91ci1vcGVuYWktYXBpLWtleSUyMiUyQyUyMk1JTFZVU19BRERSRVNTJTIyJTNBJTIybG9jYWxob3N0JTNBMTk1MzAlMjIlN0QlN0Q%3D"><img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="将claude-context MCP服务器添加到Cursor" height="32" /></a>

前往:设置 -> Cursor 设置 -> MCP -> 添加新的全局MCP服务器

推荐的方法是将以下配置粘贴到您的Cursor ~/.cursor/mcp.json 文件中。您也可以通过在项目文件夹中创建 .cursor/mcp.json 来在特定项目中安装。更多信息请参阅 Cursor MCP文档

{
  "mcpServers": {
    "claude-context": {
      "command": "npx",
      "args": ["-y", "@zilliz/claude-context-mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
      }
    }
  }
}
</details> <details> <summary><strong>Void</strong></summary>

前往:设置 -> MCP -> 添加MCP服务器

将以下配置添加到您的Void MCP设置中:

{
  "mcpServers": {
    "code-context": {
      "command": "npx",
      "args": ["-y", "@zilliz/claude-context-mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
      }
    }
  }
}
</details> <details> <summary><strong>Claude Desktop</strong></summary>

将以下配置添加到您的Claude Desktop配置中:

{
  "mcpServers": {
    "claude-context": {
      "command": "npx",
      "args": ["@zilliz/claude-context-mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "M-ILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
      }
    }
  }
}
</details> <details> <summary><strong>Windsurf</strong></summary>

Windsurf 支持通过 JSON 文件配置 MCP。将以下配置添加到您的Windsurf MCP设置中:

{
  "mcpServers": {
    "claude-context": {
      "command": "npx",
      "args": ["-y", "@zilliz/claude-context-mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
       - "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
      }
    }
  }
}
</details> <details> <summary><strong>VS Code</strong></summary>

Claude Context MCP服务器可以通过MCP兼容扩展与VS Code一起使用。将以下配置添加到您的VS Code MCP设置中:

{
  "mcpServers": {
    "claude-context": {
      "command": "npx",
      "args": ["-y", "@zilliz/claude-context-mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
      }
    }
  }
}
</details> <details> <summary><strong>Cherry Studio</strong></summary>

Cherry Studio 通过其设置界面支持可视化MCP服务器配置。虽然它不直接支持手动JSON配置,但您可以通过GUI添加新服务器:

  1. 导航到 设置 → MCP服务器 → 添加服务器
  2. 填写服务器详情:
    • 名称claude-context
    • 类型STDIO
    • 命令npx
    • 参数["@zilliz/claude-context-mcp@latest"]
    • 环境变量
      • OPENAI_API_KEYyour-openai-api-key
      • MILVUS_ADDRESSyour-zilliz-cloud-public-endpoint
      • MILVUS_TOKENyour-zilliz-cloud-api-key
  3. 保存配置以激活服务器。
</details> <details> <summary><strong>Cline</strong></summary>

Cline 使用 JSON 配置文件来管理 MCP 服务器。要集成提供的 MCP 服务器配置:

  1. 打开 Cline 并点击顶部导航栏中的 MCP 服务器 图标。

  2. 选择 已安装 标签页,然后点击 高级 MCP 设置

  3. cline_mcp_settings.json 文件中,添加以下配置:

{
  "mcpServers": {
    "claude-context": {
      "command": "npx",
      "args": ["@zilliz/claude-context-mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
      }
    }
  }
}
  1. 保存文件。
</details> <details> <summary><strong>Augment</strong></summary>

要在 Augment Code 中配置 Claude Context MCP,您可以使用图形界面或手动配置。

A. 使用 Augment Code UI

  1. 点击汉堡菜单。

  2. 选择 设置

  3. 导航到 工具 部分。

  4. 点击 + 添加 MCP 按钮。

  5. 输入以下命令:

    npx @zilliz/claude-context-mcp@latest
    
  6. 将 MCP 命名为 Claude Context

  7. 点击 添加 按钮。


B. 手动配置

  1. 按 Cmd/Ctrl Shift P 或转到 Augment 面板中的汉堡菜单。
  2. 选择 编辑设置。
  3. 在 Advanced 下,点击 在 settings.json 中编辑。
  4. 将服务器配置添加到 augment.advanced 对象中的 mcpServers 数组。
"augment.advanced": { 
  "mcpServers": [ 
    { 
      "name": "claude-context", 
      "command": "npx", 
      "args": ["-y", "@zilliz/claude-context-mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
      }
    }
  ]
}
</details> <details> <summary><strong>Roo Code</strong></summary>

Roo Code 利用 JSON 配置文件来管理 MCP 服务器:

  1. 打开 Roo Code 并导航到 设置 → MCP 服务器 → 编辑全局配置

  2. mcp_settings.json 文件中,添加以下配置:

{
  "mcpServers": {
    "claude-context": {
      "command": "npx",
      "args": ["@zilliz/claude-context-mcp@latest"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
        "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
      }
    }
  }
}
  1. 保存文件以激活服务器。
</details> <details> <summary><strong>Zencoder</strong></summary>

Zencoder 在其 JetBrains 和 VS Code 插件版本中都支持 MCP 工具和服务器。

  1. 转到 Zencoder 菜单(...)
  2. 从下拉菜单中选择 工具
  3. 点击 添加自定义 MCP
  4. 添加名称(例如 Claude Context 和以下服务器配置,并确保点击 安装 按钮
{
    "command": "npx",
    "args": ["@zilliz/claude-context-mcp@latest"],
    "env": {
      "OPENAI_API_KEY": "your-openai-api-key",
      "MILVUS_ADDRESS": "your-zilliz-cloud-public-endpoint",
      "MILVUS_TOKEN": "your-zilliz-cloud-api-key"
    }
}

  1. 通过点击 安装 按钮保存服务器。
</details> <details> <summary><strong>LangChain/LangGraph</strong></summary>

有关 LangChain/LangGraph 集成示例,请参阅 此示例

</details> <details> <summary><strong>其他 MCP 客户端</strong></summary>

该服务器使用 stdio 传输并遵循标准 MCP 协议。通过运行以下命令可以将其与任何 MCP 兼容客户端集成: