README
Exa Search MCP for DeepSeek Harness
A third-party plugin bundle that brings Exa — neural web search and full-page fetch — into DeepSeek Harness (dsh). It mounts Exa's hosted MCP endpoint (Streamable HTTP) through the MCP client bridge shipped with dsh, and registers Exa's tools as native agent tools under the exa namespace.
mcp__exa__web_search_exa · mcp__exa__web_fetch_exa
mcp__exa__web_search_advanced_exa · mcp__exa__agent_run (whitelist; agent also needs a key)
- No third-party code in the dsh process — the upstream is Exa's official hosted endpoint.
- Pure configuration bundle — one patch row; no build step, no runtime module.
- Display-ready — English/Chinese titles and descriptions plus an original SVG icon for the Plugin Manager.
Quick Start
1. Install
Option A — Plugin Manager (recommended). Open Settings → Plugins → Install and use the package name, a GitHub spec, or a local directory. The CLI equivalent:
npm install -g pnpm
dsh plugin --profile web add github:MicroHEROX/dsh-exa-mcp
dsh web
If GitHub is unstable, a
github:install can silently miss the bundle layer. Verify withdsh --profile web --dump-config | grep -A2 "== dsh-exa-mcp"; locallink:/file:installs and--patchoverlays are unaffected. The full repair procedure is in docs/SOLUTIONS.md §1.7.
Option B — One-off overlay, no install:
dsh web --patch /path/to/dsh-exa-mcp/cordis.patch.yml
Option C — Permanent without a bundle: merge the single insert block from cordis.patch.yml into $DSH_HOME/profiles/<name>/cordis.patch.yml (or $DSH_HOME/cordis.patch.yml for every profile).
Installation packs only cordis.patch.yml, locale/, icon.svg, the READMEs, and LICENSE into your runtime; docs/ stays in this repository.
2. Provide an Exa API key (optional)
The endpoint works anonymously on Exa's free tier (rate-limited, basic tools only). For higher limits and advanced tools, create an API key and set it before launching dsh:
export EXA_API_KEY="your-key" # macOS / Linux
$env:EXA_API_KEY = "your-key" # Windows PowerShell
The plugin attaches x-api-key only when the variable is present; otherwise it falls back to anonymous access. Never put the key into a patch file.
3. Verify
- Start
dsh webwith the bundle or overlay applied. - Ask: "Use Exa to find the latest DeepSeek Harness release notes and summarize them."
- Confirm the model called
mcp__exa__web_search_exa(withqueryandobjective) and, if needed,mcp__exa__web_fetch_exa.
What It Does
- Connects
https://mcp.exa.ai/mcpvia@deepseek-ai/dsh-mcp-client(streamable-http), the official bridge shipped with dsh. - Registers every tool Exa advertises as
mcp__exa__<tool>; re-syncs ontools/list_changed. - Attaches
x-api-keyonly whenEXA_API_KEYis set — noundefinedheader, no credential stored on disk. - Uses
toolCallTimeoutMs: 180000for long research calls; reconnect behavior stays at bridge defaults. - Keeps
failOnStartupError: false: an Exa outage does not reject plugin activation; the bridge logs and reconnects.
Limits
- Does not host, download, or supervise an Exa server.
- Does not implement OAuth (
?login); use an API key. - Does not bridge MCP resources or prompts — tools only.
- Does not manage Exa billing or store your key.
- Does not modify the dsh installation; install/uninstall only touches
$DSH_HOME/profiles/.
Configuration
| Goal | How |
|---|---|
| Anonymous search + fetch | Do nothing; free tier, rate-limited, 2 tools |
| Higher limits | Set EXA_API_KEY and restart dsh |
| Enable advanced search | Override url with ?tools=web_search_exa,web_fetch_exa,web_search_advanced_exa |
| Enable Exa Agent | Add agent_run to ?tools= and use an API key; billing applies |
| Change default search type | Add ?defaultSearchType=fast to url |
Override the mcp-exa row by id from a later patch layer (no insert; config is replaced wholesale). Full fields and examples: docs/API.md §2.
Uninstall
dsh plugin --profile <name> remove dsh-exa-mcp
dsh --profile <name> --dump-config | grep -c "dsh-exa-mcp" # expect 0
For --patch overlays, drop the flag. For a merged patch, delete the mcp-exa block. Uninstalling never touches the dsh installation or other bundles.
Version Compatibility
| Component | Version | Notes |
|---|---|---|
dsh-exa-mcp |
0.2.0 | See releases |
| DeepSeek Harness CLI | designed for ≥ 0.1.0-rc.5; tested on 0.2.2-rc.3 | Ships the @deepseek-ai/dsh-mcp-client bridge |
| MCP bridge | resolved from dsh; tested 0.2.2-rc.3 | No separate install |
| Exa MCP endpoint | server 3.5.1 (2026-11-16) | Exa-managed; tools/list is authoritative |
| MCP protocol | 2025-06-18 (negotiated) |
Auto-negotiated |
| Node.js | dsh requires ≥ 24.9 | Plugin itself declares no engines |
| Platform | Windows / macOS / Linux | Config-only; no platform code |
dsh is in developer preview. After a dsh upgrade, re-run the checks in docs/SOLUTIONS.md §4.
Security
更多「网页与浏览器」插件
anysearch-dsh
作者 anysearch-team
为 DeepSeek Harness 提供的 AnySearch 网页搜索提供方与高级搜索工具。
dsh-find-plugin
作者 awesome-dsh-plugin
Find DSH plugins inside the agent — live GitHub dsh-plugin topic search, star-ranked / 会话内搜索发现 DSH 插件
fnos-dsh
作者 fnosp
DeepSeek Harness应用与harness插件 monorepo
modsearch
作者 liustack
🥇 The strongest free web search plugin for DeepSeek Harness, and the search bridge for every model without native web access. Free, no signup, no API key. Ask the web or X, get structured JSON evidence. | 🥇 全网最强的 DeepSeek Harness 免费联网搜索插件,免费免注册免 API key。为不能联网的模型补上搜索,问网页或 X,拿回结构化 JSON 证据(搜索、抓取、引用)。
