MCP (模型上下文协议) 是一种使大型语言模型能够访问自定义工具和服务的协议。MCP 客户端(在本例中为 Cascade)可以向 MCP 服务器发出请求,以访问它们提供的工具。Cascade 现在原生集成了 MCP,允许您带入自己的 MCP 服务器供 Cascade 使用。有关更多信息,请参阅官方 MCP 文档

企业用户必须通过设置手动开启此功能

添加新的 MCP 插件

可以从插件商店添加新的 MCP 插件,您可以通过单击 Cascade 面板右上角菜单中的 Plugins 图标访问插件商店,或者从 Windsurf Settings > Cascade > Plugins 部分访问。

如果找不到所需的 MCP 插件,可以通过编辑原始的 mcp_config.json 文件手动添加。

官方 MCP 插件将显示蓝色勾选标记,表明它们是由母公司服务提供商制作的。

当您单击一个插件时,只需单击 Install 即可将服务器及其工具暴露给 Cascade。

Windsurf 支持 MCP 服务器的两种传输类型stdio/sse

对于 /sse 服务器,URL 应反映端点并类似于 https://<your-server-url>/sse

添加新的 MCP 插件后,请务必按下刷新按钮。

配置 MCP 工具

每个插件都有一定数量的工具可以访问。Cascade 在任何时候最多可以访问 100 个工具。

在插件级别,您可以导航到“工具”选项卡并切换您希望启用的工具。或者,从 Windsurf Settings 中,您可以单击 Manage plugins 按钮。

mcp_config.json

~/.codeium/windsurf/mcp_config.json 文件是一个 JSON 文件,其中包含 Cascade 可以连接的服务器列表。

该 JSON 应遵循与 Claude Desktop 的配置文件相同的架构。

以下是一个示例配置,它为 Google Maps 设置了一个服务器

{
  "mcpServers": {
    "google-maps": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-google-maps"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

请务必为您要使用的服务器提供必需的参数和环境变量。

有关示例服务器,请参阅官方 MCP 服务器参考仓库OpenTools

注意事项

  • 由于 MCP 工具调用可以调用任意服务器实现者编写的代码,因此我们不对 MCP 工具调用失败承担责任。重申一下
  • 我们目前仅支持工具,不支持提示也不支持资源。换句话说,Cascade 将能够请求和使用服务器的工具,但不能使用服务器暴露的其他端点。