dsh-codex-web-search-mcp
中文 | English
把 codex-web-search-mcp（模型无关的
OpenAI Codex / Grok 联网搜索与深度研究 MCP server，Rust 独立二进制）接进
DeepSeek Harness (dsh) 的
一键插件。
安装并重启 dsh web 后，3 个工具会以 dsh 原生 MCP 工具形式出现：
| 工具 | dsh 内名称 |
|---|
| 单步搜索 | mcp__codex-web-search__codex_web_search |
| 多步深度研究 | mcp__codex-web-search__codex_web_research |
| 抓正文 | mcp__codex-web-search__web_fetch |
与普通 Claude Code / Cursor 的 MCP 接入不同——本插件不依赖任何模型厂商，
搜索走 Codex 独立搜索端点，换 Gemini / OpenRouter / 本地模型都不受影响。
前置条件（重要）
本插件依赖以下已发布到 npm 的包来分发跨平台二进制：
@dhicoc/dsh-codex-web-search-mcp：本 dsh 插件；codex-web-search-mcp：跨平台命令及其平台二进制依赖；@dhicoc/codex-web-search-mcp-*：各平台的预编译二进制包。
正常使用时不需要手动安装这些依赖，dsh plugin 会自动解析并安装它们。
二进制分发包源码在
dhicoc/codex-web-search-mcp，
发布维护流程见下方「发布二进制包」。
安装
npm 发布版（推荐）
# 安装已发布的 npm 版本，并注册到 web profile
dsh plugin --profile web add @dhicoc/dsh-codex-web-search-mcp
# 重启 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。在会话中即可让 agent 调用
codex_web_search / codex_web_research / web_fetch。
如果默认 npm 镜像提示 404 Not Found，通常表示镜像尚未同步新包。可临时指定
npm 官方 registry 重试：
dsh plugin --profile web add @dhicoc/dsh-codex-web-search-mcp --registry=https://registry.npmjs.org
从 GitHub 安装（开发/预发布）
只有在测试仓库中尚未发布的提交时才使用 GitHub 源：
dsh plugin --profile web add github:dhicoc/dsh-codex-web-search-mcp
dsh web
凭证（二选一）
- 推荐：先
codex login（OAuth 写 ~/.codex/auth.json），server 自动读取，无需任何配置。
- 免 auth.json：设环境变量
CODEX_ACCESS_TOKEN（可选 CODEX_ACCOUNT_ID）。
在 cordis.patch.yml 里取消 env: 注释，用 dsh 的 !!js process.env.* 引用，
密钥不落盘。
没有有效凭证时，3 个工具会返回清晰的中文报错，而不是崩溃。
本地测试（未发布 npm 包时）
如果需要测试本地源码，可在 web profile 内使用 link: 指向本插件仓库的绝对路径：
dsh plugin --profile web add link:<本插件仓库绝对路径>
dsh web
如果本插件依赖的 codex-web-search-mcp 也尚未发布，可先在其仓库执行
npm link，再在本插件仓库执行 npm link codex-web-search-mcp，最后安装本插件的
link: 版本。普通用户不需要这些步骤，应使用上面的 npm 发布版安装方式。
卸载与还原
dsh plugin --profile web remove @dhicoc/dsh-codex-web-search-mcp
删除插件即移除 mcp-codex-web-search 这一行，dsh 不再加载该 MCP server，
不影响其它能力。
降级：不用插件，直接用 dsh 原生 MCP 配置
dsh 内置 @deepseek-ai/dsh-mcp-client 本就会读 .mcp.json / ~/.dsh/mcp.json。
如果你不想走插件，也可以手动把下面这段写进任一 MCP 配置文件（效果等价）：
{
"mcpServers": {
"codex-web-search": {
"command": "codex-web-search-mcp"
}
}
}
或在 ~/.dsh/profiles/web/cordis.patch.yml 追加：
- insert:
- id: mcp-codex-web-search
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: codex-web-search
transport: stdio
command: codex-web-search-mcp
发布二进制包（维护者）
二进制需在 dhicoc/codex-web-search-mcp 仓库根的 npm/platforms/<平台>/bin/ 下就位
（统一名 bin/codex-web-search-mcp[.exe]，可从 Releases v2.3.1 下载）。再按依赖顺序发布：
-
依次发布 5 个平台子包（在 dhicoc/codex-web-search-mcp 仓库根执行）：
cd npm/platforms/win32-x64 && npm publish --access public
cd ../win32-arm64 && npm publish --access public
cd ../darwin-universal && npm publish --access public
cd ../linux-x64 && npm publish --access public
cd ../linux-arm64 && npm publish --access public
-
再发布 umbrella 包（带 bin shim + optionalDependencies）：
cd ../.. && npm publish --access public
-
最后在本插件仓库发布本插件：
npm publish --access public
-
给仓库打 dsh-plugin topic，自动被 awesome-dsh-plugins 收录。
工作原理
- 本仓库是一个配置型 Cordis bundle：
cordis.patch.yml 借用 dsh 自带的
@deepseek-ai/dsh-mcp-client，用一行 config 把它实例化成指向
codex-web-search-mcp 二进制的 stdio server（serverName: codex-web-search）。
codex-web-search-mcp 依赖通过 optionalDependencies 按当前平台拉取对应
预编译二进制包，并暴露 bin/codex-web-search-mcp 命令（一个轻量 JS shim，
运行时定位已安装的平台二进制并 spawn，无需 postinstall，规避 pnpm
allowBuilds 墙）。
许可证
MIT（与上游 codex-web-search-mcp 一致）。
