DeepSeek Web Search

mcp-deepseek-search

Model Context Protocol サーバーです。DeepSeek のウェブ Search および Fetch ツールを、Claude Desktop、Claude Code、Cursor、Cline、ZCode など、あらゆる MCP クライアントに提供します。

あらゆる LLM で動作します。検索には DeepSeek 独自の検索エンジンを使用しますが、結果は通常のツール出力として既存のモデルに返されます。

機能

• deepseek_search — DeepSeek の検索エンジンを利用したウェブ検索。各結果には、次の 2 つの品質シグナルが含まれます。
  • rerank_score（0～3）：関連性。1.5 以上 = 関連性が非常に高い
  • authority（0～4、-1 は不明）：情報源の権威性。3 以上 = 権威性が非常に高い
• deepseek_fetch — 単一ページを取得し、本文を Markdown 形式で取得します
• 強力なクエリ構文：site:、-site:、-term、"exact phrase"、-"phrase"、lang:zh,en、after:YYYY-MM-DD、before:YYYY-MM-DD
• 組み込みのスロットリング（アカウントの上限である 5 QPS を超えないよう制御）と、408／429／5xx 発生時の自動再試行
• レスポンスサイズに配慮：デフォルトでは要約を返し、リクエストがあった場合のみページ全文を返します

セットアップ

1. platform.deepseek.com で API キーを取得します（ウェブツールの料金は 成功した呼び出し 1,000 回あたり ¥5 で、DeepSeek アカウントに請求されます。失敗した呼び出しや結果が空の場合は請求されません）。
2. MCP クライアントの設定にサーバーを追加します。

Claude Desktop／Cursor／Cline／ほとんどのクライアント

{
  "mcpServers": {
    "deepseek-web": {
      "command": "npx",
      "args": ["-y", "mcp-deepseek-search"],
      "env": {
        "DEEPSEEK_API_KEY": "sk-your-key-here"
      }
    }
  }
}

ZCode

同じ mcpServers ブロックを ZCode の MCP 設定に追加します（Settings → MCP → Add server）。

ソースから

git clone https://github.com/Matthewyin/deepseek-mcp
cd deepseek-mcp && npm install && npm run build
node dist/index.js   # stdio MCP server

ツール

deepseek_search

パラメーター	型	必須	説明
query	string	はい	1～128 文字。上記の検索構文に対応
count	integer	いいえ	結果数は 1～50、デフォルトは 10（料金には影響しません）
ori_question	string	いいえ	ユーザーの元の質問。クエリが書き換えられた場合に、意図のマッチング精度を高めます
localization	string	いいえ	結果をローカライズするためのユーザーの IP（同意を得た場合のみ指定してください）
need_content	boolean	いいえ	各結果のページ全文を含めます（それぞれ 8,000 文字で切り捨てられます）。デフォルトは false

各結果には、title、url、snippet（表示用の短いテキスト）、summary（モデルに渡すための長い要約）、rerank_score、authority、site_name、date、および任意で content が含まれます。

deepseek_fetch

パラメーター	型	必須	説明
url	string	はい	通常の http(s) URL。最大 8,192 文字。認証情報を埋め込むことはできません

title と Markdown 形式の content を返します（30,000 文字で切り捨てられます）。

使用例

エージェントに次のように依頼します。「deepseek_search で最近 1 週間の MCP に関する大きなニュースを検索し、権威ある情報源を選んでから、deepseek_fetch で全文を読んで要約して」。または英語で次のように依頼します。「DeepSeek に関する最近のニュースを検索し、authority が 3 以上の結果だけを残して、最上位の結果を取得して要約してください。」

注意事項と制限

• レート制限は DeepSeek アカウントあたり 5 QPS です（すべての API キーで共有）。サーバーが自動的にスロットリングします。
• HTTP 402 は DeepSeek の残高不足、401 はキーが無効であることを示します。
• ページのコンテンツは、対象サイトの可用性とアクセス方針に依存します。
• これは非公式のコミュニティ製ラッパーであり、DeepSeek とは提携していません。

開発

npm install
npm run build
DEEPSEEK_API_KEY=sk-... npm test   # end-to-end test against the real API

リリースは GitHub Actions によって自動化されています。v* タグをプッシュすると、npm と公式 MCP Registry に公開されます。

ライセンス

MIT