Windsurf Cascade 中配置 MCP Server：从零打造自动化全栈开发流

Windsurf 与 Cascade 简介

Windsurf 是由 Codeium 打造的新一代 AI 原生 IDE，其核心 Cascade Agent 具备出色的多文件协同与意图推理能力。随着 MCP 协议成为行业标准，Windsurf 也提供了对 MCP 的无缝支持。

1. 配置文件位置

Windsurf 的 MCP 配置文件位于：

• Linux/macOS: ~/.codeium/windsurf/mcp_config.json
• Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

2. 推荐实用配置清单

以下是一个推荐的前端全栈开发 MCP 配置：

{
  "mcpServers": {
    "git": {
      "command": "uvx",
      "args": ["mcp-server-git", "--repository", "."]
    },
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    }
  }
}

3. 在 Cascade 中调用工具

配置完成后，Cascade 在理解用户指令时，会自动根据工具的 Schema 判断何时调用。例如：

• 输入：“查看最近一次 commit 的修改内容，并帮我编写对应的 Release Notes”
• Cascade 会自动调用 git MCP 中的 git_diff 或 git_log 获取改动，并直接起草文档。

4. 调试技巧

如果 Cascade 未能识别新添加的 MCP 工具：

1. 检查 Node.js / uv 环境是否处于全局系统 PATH 中；
2. 检查 JSON 语法是否含有未转义的反斜杠（Windows 路径需用 \\ 或 /）；
3. 可以在 Windsurf 开发者控制台（Developer Tools）查看 MCP Server 启动日志。