前言¶
在 DeepSeek Harness(dsh)裏給 agent 增加聯網搜索與深度研究能力時,常見做法是先準備 MCP server,再手動配置 dsh,最後驗證 dsh web 是否加載成功。下面介紹一個一鍵插件:dhicoc/dsh-codex-web-search-mcp。它把 codex-web-search-mcp 接進 dsh,減少手動配置步驟。
這裏的插件目錄是社區線索,不等同於 DeepSeek 官方應用商店。
這是什麼¶
dhicoc/dsh-codex-web-search-mcp 是一個 dsh 插件,用於把 codex-web-search-mcp 註冊爲 dsh 內可調用的工具。上游 codex-web-search-mcp 是模型無關的 OpenAI Codex / Grok 聯網搜索與深度研究 MCP server,底層是 Rust 獨立二進制。
插件維護者爲 dhicoc,許可證爲 MIT,與上游 codex-web-search-mcp 一致。
核心能力¶
安裝並重啓 dsh web 後,會話中會出現 3 個工具:
- 單步搜索:
mcp__codex-web-search__codex_web_search - 多步深度研究:
mcp__codex-web-search__codex_web_research - 抓正文:
mcp__codex-web-search__web_fetch
這些工具不依賴任何模型廠商,搜索走 Codex 獨立搜索端點。沒有有效憑證時,3 個工具會返回清晰的中文報錯,而不是崩潰。
安裝與啓用¶
先安裝 npm 發佈版,並註冊到 web profile:
dsh plugin --profile web add @dhicoc/dsh-codex-web-search-mcp
這一步會安裝插件,並讓 dsh 解析相關依賴。插件包與二進制依賴包括:
@dhicoc/dsh-codex-web-search-mcpcodex-web-search-mcp@dhicoc/codex-web-search-mcp-*
dsh plugin 會自動解析並安裝這些依賴。
安裝後需要重啓 dsh web 進程:
dsh web
Web bundle 無 HMR,必須重啓 dsh web 進程。
重啓後檢查配置:
dsh --profile web --dump-config
輸出中應出現 mcp-codex-web-search,幷包含 serverName: codex-web-search 和 command: codex-web-search-mcp。
如果默認 npm 鏡像提示 404 Not Found,通常表示鏡像尚未同步新包,可臨時指定 npm 官方 registry 重試。
憑證¶
憑證二選一:
- 先執行
codex login。OAuth 會寫入~/.codex/auth.json,server 自動讀取。 - 設置環境變量
CODEX_ACCESS_TOKEN,可選設置CODEX_ACCOUNT_ID。
典型用法¶
經過上面的步驟後,在會話中可以讓 agent 調用:
codex_web_search:做單步搜索codex_web_research:做多步深度研究web_fetch:抓取正文
適用場景與注意¶
- 適合在 dsh 的
webprofile 中接入聯網搜索與深度研究工具。 - 插件會加載外部 MCP server 二進制,並以當前 dsh 進程權限運行;安裝前建議檢查源碼、依賴與許可證。
- 刪除插件後,會移除
mcp-codex-web-search這一行,dsh 不再加載該 MCP server,不影響其它能力。
結尾¶
這個插件把 codex-web-search-mcp 的聯網搜索與深度研究能力接入 dsh,安裝、驗證和憑證配置都有明確入口。
GitHub 倉庫:https://github.com/dhicoc/dsh-codex-web-search-mcp
目錄頁(插件線索):https://www.skillhub.cn/plugins/dhicoc/dsh-codex-web-search-mcp