DeepSeek Web Search

mcp-deepseek-search

[npm version] [License: MIT] [MCP Registry]

An Model Context Protocol server that exposes DeepSeek's web Search and Fetch tools to any MCP client — Claude Desktop, Claude Code, Cursor, Cline, ZCode, and more.

Works with any LLM: the search runs on DeepSeek's own search engine, but the results are returned to your existing model as ordinary tool output.

Features

• deepseek_search — web search backed by DeepSeek's search engine, with two quality signals per result:
  • rerank_score (0–3): relevance; ≥ 1.5 = highly relevant
  • authority (0–4, -1 unknown): source authority; ≥ 3 = highly authoritative
• deepseek_fetch — fetch a single page and get its main content as Markdown
• Powerful query syntax: site:, -site:, -term, "exact phrase", -"phrase", lang:zh,en, after:YYYY-MM-DD, before:YYYY-MM-DD
• Built-in throttling (stays under the 5 QPS account limit) and automatic retry on 408/429/5xx
• Response-size friendly: summaries by default, full page text only on request

Setup

1. Get an API key at platform.deepseek.com (web tools are billed at ¥5 per 1,000 successful calls, charged to your DeepSeek account — failed calls and empty results are not billed).
2. Add the server to your MCP client config:

Claude Desktop / Cursor / Cline / most clients

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

ZCode

Add the same mcpServers block to your ZCode MCP settings (Settings → MCP → Add server).

From source

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

Tools

deepseek_search

Each result includes title, url, snippet (short, for display), summary (long, for feeding to a model), rerank_score, authority, site_name, date, and optionally content.

deepseek_fetch

Returns title + Markdown content (truncated at 30,000 chars).

Example

Ask your agent: "用 deepseek_search 搜一下最近一周关于 MCP 的大新闻，挑权威来源，再用 deepseek_fetch 读全文总结" — or in English: "Search for recent DeepSeek news, keep only results with authority ≥ 3, fetch the top one and summarize."

Notes & limits

• Rate limit is 5 QPS per DeepSeek account (shared across all your API keys); the server throttles automatically.
• HTTP 402 means your DeepSeek balance ran out; 401 means the key is invalid.
• Page content depends on the target site's availability and access policy.
• This is an unofficial community wrapper; not affiliated with DeepSeek.

Development

npm installnpm run buildDEEPSEEK_API_KEY=sk-... npm test   # end-to-end test against the real API

Releases are automated via GitHub Actions: pushing a v* tag publishes to npm and the official MCP Registry.

License

MIT