ディレクトリに戻る

dsh-exa-mcp

キュレーションリスト掲載メンテナンス: 活発

microherox/dsh-exa-mcp

@deepseek-ai/dsh-mcp-client ブリッジ経由でリモート Exa MCP エンドポイント(https://mcp.exa.ai/mcp)をマウントする DeepSeek Harness 向け Exa 検索プラグイン

GitHub で見る
$ dsh plugin add dsh-exa-mcp

インストール方法

dsh には中央のインストールコマンドはありません。このプラグインのエントリ(README に記載)をプロファイルまたはパッチ設定に追加し、再起動します。

インストールの仕組み

4

スター

0

フォーク

MIT

ライセンス

2026-08-14

作成日

2026-11-15

最終プッシュ

README

Exa Search MCP for DeepSeek Harness

中文

License: MIT dsh-plugin stars

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 with dsh --profile web --dump-config | grep -A2 "== dsh-exa-mcp"; local link:/file: installs and --patch overlays 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

  1. Start dsh web with the bundle or overlay applied.
  2. Ask: "Use Exa to find the latest DeepSeek Harness release notes and summarize them."
  3. Confirm the model called mcp__exa__web_search_exa (with query and objective) and, if needed, mcp__exa__web_fetch_exa.

What It Does

  • Connects https://mcp.exa.ai/mcp via @deepseek-ai/dsh-mcp-client (streamable-http), the official bridge shipped with dsh.
  • Registers every tool Exa advertises as mcp__exa__<tool>; re-syncs on tools/list_changed.
  • Attaches x-api-key only when EXA_API_KEY is set — no undefined header, no credential stored on disk.
  • Uses toolCallTimeoutMs: 180000 for 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

GitHub で README 全文を読む →

DSH Plugins は DeepSeek Harness プラグインの独立したコミュニティ ディレクトリです。DeepSeek との提携・公認はありません。サードパーティ製プラグインはセキュリティ監査を受けていません。インストール前にソースコードをご確認ください。

DeepSeek Harnessの新着プラグインを毎週お届け。スパムはありません。