如何在 Windsurf 中添加 MCP 服务器（mcp_config.json）

在 mcp_config.json 中为 Windsurf 的 Cascade 智能体配置本地和远程 MCP 服务器：文件位置、远程服务器的 serverUrl 以及如何停用工具。

1. 打开 mcp_config.json

在 Cascade 面板右上角点击 …（Actions）菜单，在 MCPs 部分选择 Open MCP config file。根据当前文档，该文件在 macOS 和 Linux 上位于 ~/.config/devin/mcp_config.json，在 Windows 上位于 %APPDATA%\devin\mcp_config.json（Windsurf 现已并入 Devin Desktop；旧版 Windsurf 使用 ~/.codeium/windsurf/mcp_config.json）。通过菜单打开总能找到正确的文件。

2. 添加本地（stdio）服务器

在 mcpServers 下添加一项，格式与 Claude Desktop 和 Cursor 相同：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

3. 添加远程服务器

远程 HTTP 服务器使用 serverUrl（或 url）代替命令。以免费的 Socketlist 服务器为例：

{
  "mcpServers": {
    "socketlist": {
      "serverUrl": "https://socketlist.pages.dev/mcp"
    }
  }
}

如果服务器需要 API 密钥，请添加 headers 对象。

4. 不要把密钥写进文件

配置支持在 command、args、env、serverUrl、url 和 headers 中使用 ${env:VAR_NAME} 与 ${file:/path/to/file}。

5. 启用或停用服务器和工具

Actions 菜单的 MCPs 部分为每个服务器提供开关。要隐藏单个工具，在服务器条目中加入 "disabledTools": ["tool_name"]。Cascade 同时最多可使用 100 个工具。

说明

以上内容适用于 Cascade 智能体。较新的 Devin Local 智能体则把 MCP 服务器保存在 Devin CLI 配置中。来源：Cascade 官方 MCP 文档。