Introduction

When adding web search and deep research capabilities to an agent in DeepSeek Harness (dsh), a common practice is to first prepare the MCP server, then manually configure dsh, and finally verify if dsh web loads successfully. Below is an “all-in-one” plugin: dhicoc/dsh-codex-web-search-mcp. It integrates codex-web-search-mcp into dsh, reducing manual configuration steps.

The plugin directory here is a community lead/resource, not equivalent to the DeepSeek official app store.

What is this

dhicoc/dsh-codex-web-search-mcp is a dsh plugin used to register codex-web-search-mcp as a callable tool within dsh. The upstream codex-web-search-mcp is a model-agnostic OpenAI Codex / Grok web search and deep research MCP server, built upon a Rust standalone binary.

The plugin maintainer is dhicoc, the license is MIT, consistent with the upstream codex-web-search-mcp.

Core Capabilities

After installing and restarting dsh web, 3 tools will appear in the session:

  • Single-step search: mcp__codex-web-search__codex_web_search
  • Multi-step deep research: mcp__codex-web-search__codex_web_research
  • Fetch content: mcp__codex-web-search__web_fetch

These tools do not depend on any model vendor; the search uses the standalone Codex search endpoint. When there are no valid credentials, the 3 tools will return clear Chinese error messages instead of crashing.

Installation and Enablement

First, install the npm release version and register it to the web profile:

dsh plugin --profile web add @dhicoc/dsh-codex-web-search-mcp

This step installs the plugin and allows dsh to parse related dependencies. The plugin package and binary dependencies include:

  • @dhicoc/dsh-codex-web-search-mcp
  • codex-web-search-mcp
  • @dhicoc/codex-web-search-mcp-*

dsh plugin will automatically parse and install these dependencies.

After installation, you need to restart the dsh web process:

dsh web

The Web bundle has no HMR (Hot Module Replacement), so the dsh web process must be restarted.

After restarting, check the configuration:

dsh --profile web --dump-config

The output should show mcp-codex-web-search and include serverName: codex-web-search and command: codex-web-search-mcp.

If the default npm mirror prompts 404 Not Found, it usually means the mirror has not yet synchronized the new package; you can retry by temporarily specifying the official npm registry.

Credentials

Choose one of two methods for credentials:

  1. Execute codex login first. OAuth writes to ~/.codex/auth.json, which the server reads automatically.
  2. Set the environment variable CODEX_ACCESS_TOKEN, optionally setting CODEX_ACCOUNT_ID.

Typical Usage

After the steps above, you can allow the agent to call:

  • codex_web_search: for single-step search
  • codex_web_research: for multi-step deep research
  • web_fetch: to fetch content

Use Cases and Notes

  • Suitable for integrating web search and deep research tools into the web profile of dsh.
  • The plugin loads the external MCP server binary and runs it with the current dsh process permissions; it is recommended to check the source code, dependencies, and license before installation.
  • After removing the plugin, the mcp-codex-web-search line will be removed, and dsh will no longer load that MCP server, without affecting other capabilities.

Conclusion

This plugin integrates the web search and deep research capabilities of codex-web-search-mcp into dsh, with clear entry points for installation, verification, and credential configuration.

GitHub Repository: https://github.com/dhicoc/dsh-codex-web-search-mcp

Directory Page (Plugin Lead): https://www.skillhub.cn/plugins/dhicoc/dsh-codex-web-search-mcp