mcp-deepseek-search
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 relevantauthority(0–4,-1unknown): 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
- 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).
- 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-mcp
cd deepseek-mcp && npm install && npm run build
node 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 install
npm run build
DEEPSEEK_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.