想让 Cascade 代你准备配置？ 把这篇文章发给你的编码 Agent，请它检查当前 MCP 配置、合并 DeepSeek 条目并展示变更。API 密钥请在本地输入，不要粘贴到聊天中。
Use this guide to add DeepSeek Search to my Windsurf Cascade setup. First
inspect the MCP configuration path for the Cascade version I am running. Keep
all existing servers, add the local DeepSeek adapter as a separate entry, and
load the key from a private env file or environment variable. Do not read or
print the secret. Show me the JSON diff and explain how to refresh Cascade and
check the two tools. Do not make a billable request until I approve it.Cascade 可以通过本地 MCP 服务器使用 DeepSeek Search。配置由一段 JSON 和 Cascade MCP 面板中的刷新操作组成。需要特别注意版本：Windsurf 的 MCP 文档现在会跳转到 Devin 文档，其中写明这套配置适用于旧版 Cascade Agent。复制配置前，先确认你安装的 Cascade 版本仍使用此路径。当前 Cascade MCP 文档
先决定密钥存放位置
DeepSeek 提供 HTTP Search 与 Fetch API。Cascade 需要 MCP 桥接服务才能将它们作为工具调用。请使用 Claude Code 配置指南中介绍的 Node 适配器和 search-cli.mjs 助手。在本机私密目录安装固定版本依赖，并使用 Node.js 22 或更高版本。
在项目目录之外建立独立 .env 文件，写入 DEEPSEEK_API_KEY=...，并限制文件权限。下面示例让 Cascade 启动桥接程序时由 Node 读取该文件。将两条路径改为本机绝对路径：
{
"mcpServers": {
"deepseek-search": {
"command": "node",
"args": [
"--env-file=/Users/you/.config/deepseek-search/.env",
"/Users/you/.local/share/deepseek-search/server.mjs"
]
}
}
}Cascade 当前文档列出的 macOS/Linux 配置路径是 ~/.config/devin/mcp_config.json，若设置了 $XDG_CONFIG_HOME，则使用 $XDG_CONFIG_HOME/devin/mcp_config.json；Windows 路径为 %APPDATA%\devin\mcp_config.json。由于 Windsurf 的文档已迁移，且 Cascade MCP 页面将此 Agent 标为旧版，优先使用已安装 Cascade 面板中的 Open MCP config file 操作，避免编辑过时或错误的文件。将 deepseek-search 对象合并到现有 mcpServers 中。Cascade 配置位置与格式
如果安装版本支持 Cascade 文件插值，可以将密钥放在只有一行的密钥文件中。不过对该适配器而言，Node 的 --env-file 更简单，因为它会为实际发送 API 请求的子进程设置环境变量。
编辑前先从当前 Cascade 面板打开正在使用的配置文件。
刷新 Cascade 并检查可调用工具
保存配置后，打开 Cascade 的 Actions 菜单并查看 MCP 区域。服务器应出现在列表中并处于启用状态。如果没有出现，重启 Cascade 或刷新 MCP 列表。当前文档支持逐服务器开关和 disabledTools 数组。适配器会公布 deepseek_search 与 deepseek_fetch，因此在“先搜索、再核对来源”的流程中要同时保留这两个工具。
让 Cascade 回答一个关于官方产品文档的具体问题。查看工具活动，确认它调用了 Search、对选定 URL 执行 Fetch，最后引用该 URL。搜索结果摘要只能帮助定位页面；Fetch 才能返回供核对和引用的正文。
MCP 连接成功只证明 Cascade 启动了本地适配器并发现了工具，不代表 DeepSeek 已接受密钥。实际 API 调用需要读者自己的密钥，并可能按 DeepSeek 当前的 Search 与 Fetch API 价格收费。
请按照你本机安装的 Agent 版本选择对应文档。
Cascade 看不到工具时怎么办
根据失败点检查。如果 JSON 文件未加载，先验证括号和逗号，再确认编辑的是 Cascade 实际打开的文件。如果服务器显示但没有工具，用相同 Node 可执行文件和环境文件在终端测试适配器。如果工具可见但调用返回认证错误，修正本地环境文件并重启 Cascade。不要把请求头或密钥文件内容贴到聊天或公开问题报告中。
Cascade MCP 文档指出启用工具总数上限为 100。如果你已经接入多个服务器，添加新服务前先关闭无关工具。Search 只读，但 MCP 进程仍会执行本地代码；请将适配器安装在可信目录，并启用前检查服务器路径。
只需查询一次时跳过持久 MCP
如果只需要一个结果，可以使用 Claude Code 指南里的 CLI 助手，而不用把工具长期添加到 Cascade：
node --env-file=/Users/you/.config/deepseek-search/.env \
/Users/you/.local/share/deepseek-search/search-cli.mjs \
search "Windsurf Cascade MCP configuration" 3对选定 URL 再运行它的 fetch 子命令。这是手动终端查询，Cascade 无法在聊天中按工具名称选择它。反复研究时 MCP 更顺手；只验证一次时，CLI 助手步骤更短。
当 Cascade 的 MCP 面板显示适配器、两个工具都可见，并且一次获准的 Search → Fetch 任务返回有来源支持的回答时，接入完成。如果 Cascade 版本更新，请重新核对已安装产品的说明，因为 Windsurf 文档目前通过 Devin 的旧版 Cascade 指南提供信息。
作者 Martin Hayes，Auspia GEO 实施手册作者，撰写超过 200 份执行清单，专注实用配置指南和可重复的落地流程。
探索更多 DeepSeek Search 接入指南
相关平台指南：使用 MCP 和 Profile 为 Warp Agent 接入 DeepSeek Search · Claude Code
