前言¶

在 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-mcp
• codex-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 重试。

凭证¶

凭证二选一：

1. 先执行 codex login。OAuth 会写入 ~/.codex/auth.json，server 自动读取。
2. 设置环境变量 CODEX_ACCESS_TOKEN，可选设置 CODEX_ACCOUNT_ID。

典型用法¶

经过上面的步骤后，在会话中可以让 agent 调用：

• codex_web_search：做单步搜索
• codex_web_research：做多步深度研究
• web_fetch：抓取正文

适用场景与注意¶

• 适合在 dsh 的 web profile 中接入联网搜索与深度研究工具。
• 插件会加载外部 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