想讓 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




