跳到主要内容
版本：v3.0.x

Milvus SDK Code Helper 指南

概述​

Milvus SDK Code Helper 是一个基于 Model Context Protocol（MCP）的开发辅助服务，可为 Claude Code、Cursor、VS Code 等 AI coding assistant 提供与当前 Milvus SDK 一致的 API 上下文。配置后，AI coding assistant 可以优先使用推荐的 MilvusClient API，减少生成过时 ORM API 的情况。

按照下方步骤为所使用的工具配置远程 MCP Server。

效果对比​

下图对比启用和未启用 Milvus SDK Code Helper 时生成的代码。启用后，AI coding assistant 会优先采用当前推荐的 MilvusClient API；未启用时，可能仍生成旧版 ORM API。

已启用 SDK Code Helper

禁用 SDK Code Helper

Code Helper Enabled

Code Helper Disabled

使用官方推荐的最新 MilvusClient API 创建 Collection

不推荐使用旧版 ORM API 创建 Collection。

快速配置​

选择所使用的 AI coding assistant，并按照对应步骤添加 Milvus SDK Code Helper MCP Server。

Cursor​

转到 Settings → Cursor Settings → Tools & Integrations → Add new global MCP server

Cursor Mcp Settings

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

JSON
{
  "mcpServers": {
    "sdk-code-helper": {
      "url": "https://sdk.milvus.io/mcp/",
      "headers": {
        "Accept": "text/event-stream"
      }
    }
  }
}

Claude Desktop​

添加到您的 Claude Desktop 配置中：

JSON
{
  "mcpServers": {
    "sdk-code-helper": {
      "url": "https://sdk.milvus.io/mcp/",
      "headers": {
        "Accept": "text/event-stream"
      }
    }
  }
}

Claude Code​

Claude Code 支持通过 JSON 配置直接添加 MCP Server，包括远程 URL 类型的服务器。使用以下命令向 Claude Code 添加配置：

Shell
claude mcp add-json sdk-code-helper --json '{
  "url": "https://sdk.milvus.io/mcp/",
  "headers": {
    "Accept": "text/event-stream"
  }
}'

Windsurf​

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

JSON
{
  "mcpServers": {
    "sdk-code-helper": {
      "url": "https://sdk.milvus.io/mcp/",
      "headers": {
        "Accept": "text/event-stream"
      }
    }
  }
}

VS Code​

Milvus SDK Code Helper 可通过 MCP 兼容扩展与 VS Code 一起使用。在 VS Code MCP 设置中添加以下配置：

JSON
{
  "mcpServers": {
    "sdk-code-helper": {
      "url": "https://sdk.milvus.io/mcp/",
      "headers": {
        "Accept": "text/event-stream"
      }
    }
  }
}

Cherry Studio​

Cherry Studio 允许通过其设置界面对 MCP Server 进行可视化配置。虽然它不直接支持手动 JSON 配置，但你可以通过图形用户界面添加新服务器：

  1. 导航至设置 → MCP Server → 添加服务器。

  2. 填写服务器详细信息：

  • 名称：sdk code helper

  • 类型 Streamable HTTP

  • URL：https://sdk.milvus.io/mcp/

  • Header："Accept": "text/event-stream"

  1. 保存配置以激活服务器。

Cherry Studio Mcp Settings

Cline​

Cline 使用 JSON 配置文件管理 MCP Server。要整合所提供的 MCP Server 配置，请

  1. 打开 Cline，点击顶部导航栏中的 MCP Server 图标。

  2. 选择“已安装”选项卡，然后点击“高级 MCP 设置”。

  3. 在 cline_mcp_settings.json 文件中，添加以下配置：

JSON
{
  "mcpServers": {
    "sdk-code-helper": {
      "url": "https://sdk.milvus.io/mcp/",
      "headers": {
        "Accept": "text/event-stream"
      }
    }
  }
}

增强​

  1. 按 Cmd/Ctrl Shift P 或转到 Augment 面板中的汉堡包菜单

  2. 选择编辑设置

  3. 在“高级”区域点击 settings.json 的“编辑”。

  4. 将服务器配置添加到 augment.advanced 对象中的 mcpServers 数组：

JSON
{
  "mcpServers": {
    "sdk-code-helper": {
      "url": "https://sdk.milvus.io/mcp/",
      "headers": {
        "Accept": "text/event-stream"
      }
    }
  }
}

Gemini CLI​

Gemini CLI 需要通过 JSON 文件手动配置：

  1. 创建或编辑 ~/.gemini/settings.json 文件。

  2. 添加以下配置：

JSON
{
  "mcpServers": {
    "sdk-code-helper": {
      "url": "https://sdk.milvus.io/mcp/",
      "headers": {
        "Accept": "text/event-stream"
      }
    }
  }
}
  1. 保存文件并重启 Gemini CLI 以应用更改。

Roo Code​

Roo Code 使用 JSON 配置文件管理 MCP Server：

  1. 打开 Roo Code，导航至设置 → MCP Server → 编辑全局配置。

  2. 在 mcp_settings.json 文件中，添加以下配置：

JSON
{
  "mcpServers": {
    "sdk-code-helper": {
      "url": "https://sdk.milvus.io/mcp/",
      "headers": {
        "Accept": "text/event-stream"
      }
    }
  }
}
  1. 保存文件以激活服务器。