deepseek-search-fetch-mcp

A Model Context Protocol (MCP) server that exposes the official DeepSeek Search / Fetch API as two MCP tools: search and fetch.

• search — search the web with the DeepSeek in-house search engine and get structured results (title, URL, snippet, summary, content, site info, date, authority, rerank score).

• fetch — fetch a single web page and return its title and full content in Markdown.

简体中文说明（Simplified Chinese）→ README.zh-CN.md

⚠️ Disclaimer

This project is an independent, community-built open-source implementation and is NOT affiliated with, endorsed by, or sponsored by DeepSeek (深度求索).

• "DeepSeek" and related names are trademarks of their respective owners.

• The copyright of this project and all its versions belongs to its holder, web4theme.

• This project simply wraps the public DeepSeek Search / Fetch API. You are responsible for your own API usage, billing, and compliance with DeepSeek's terms of service.

Related MCP server: dseek-mcp

How it works

MCP client ──stdio──▶ deepseek-search-fetch-mcp ──HTTPS──▶ api.deepseek.com
                            (search → POST /v1/tools/search
                             fetch  → POST /v1/tools/fetch)

The tools call the DeepSeek API endpoints documented at api-docs.deepseek.com:

Tools

search

Search the web and return structured results as JSON.

Each result contains: rerank_score, title, url, snippet, summary, content, site_name, site_icon, date (RFC 3339 UTC), authority.

fetch

Fetch a web page and return its title and Markdown content.

Search syntax

The query supports the following operators (pass them to search exactly as documented by DeepSeek):

Example: query="DeepSeek site:github.com OR site:huggingface.co lang:zh after:2025".

Requirements

• Python 3.10+

• A DeepSeek API key (platform.deepseek.com/api_keys)

• uv (recommended) or pip

Installation

Option A — clone and run with uv (recommended)

git clone https://github.com/web4theme/deepseek-search-fetch-mcp.git
cd deepseek-search-fetch-mcp
uv sync

Option B — pip

git clone https://github.com/web4theme/deepseek-search-fetch-mcp.git
cd deepseek-search-fetch-mcp
pip install .

Configuration

Set the environment variables before starting the server:

Usage with MCP clients

Claude Code

claude mcp add deepseek-search-fetch -- \
  uv run --directory /path/to/deepseek-search-fetch-mcp deepseek-search-fetch

Cursor / other stdio clients

Add to your MCP client configuration (JSON):

{
  "mcpServers": {
    "deepseek-search-fetch": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/deepseek-search-fetch-mcp", "deepseek-search-fetch"],
      "env": {
        "DEEPSEEK_API_KEY": "your-api-key"
      }
    }
  }
}

Note: tool names are search and fetch, which may collide with tools from other MCP servers. If you run multiple search MCP servers, rename the tools in this repo (they are registered in src/deepseek_search_fetch/server.py) or namespace them in your client.

Error handling

The server surfaces the API's errors (OpenAI-compatible format) with their HTTP status code:

The client automatically retries 408/429/5xx with exponential backoff (up to DEEPSEEK_MAX_RETRIES). Other 4xx errors are not retried, per DeepSeek's guidance.

Billing & rate limits (per DeepSeek docs)

• Both Search and Fetch are billed per successful request: ¥5 per 1,000 successful requests (Search) and ¥5 per 1,000 (Fetch). Requests that fail, return no results, or time out are not billed. count does not affect the price.

• Rate limits are per account: Search 100 QPS, Fetch 25 QPS, independent of each other.

See the official Web Search & Fetch guide for the latest information.

Development

uv sync
# Run the server on stdio (requires DEEPSEEK_API_KEY):
DEEPSEEK_API_KEY=sk-... uv run deepseek-search-fetch
# Or invoke as a module:
DEEPSEEK_API_KEY=sk-... uv run python -m deepseek_search_fetch

License

MIT — see LICENSE. Copyright (c) 2026 web4theme.