Skip to content
Back to search

deepseek-search-mcp

Minimal single-file MCP server for the DeepSeek Web Search API (stdio, PEP 723 inline deps, zero-install, drop-in web_search)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/haohaoo3o--deepseek-search-mcp/badge.svg)](/listings/haohaoo3o--deepseek-search-mcp)

HTML

<a href="/listings/haohaoo3o--deepseek-search-mcp"><img src="/api/listings/haohaoo3o--deepseek-search-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Get a DeepSeek API key from the [DeepSeek Open Platform](https://platform.deepseek.com/) 2. Point any stdio MCP client at `server.py` with `DEEPSEEK_API_KEY` set

Search requests are billed to your own DeepSeek account (about 5 CNY per 1,000 successful requests; failed or empty-result requests are free).

Client configuration

Run-from-URL (no clone needed):

{
  "mcpServers": {
    "deepseek-web-search": {
      "command": "uv",
      "args": [
        "run",
        "https://raw.githubusercontent.com/haohaoo3o/deepseek-search-mcp/main/server.py"
      ],
      "env": { "DEEPSEEK_API_KEY": "sk-..." }
    }
  }
}

Or after cloning:

{
  "command": "uv",
  "args": ["run", "--no-project", "/absolute/path/to/deepseek-search-mcp/server.py"],
  "env": { "DEEPSEEK_API_KEY": "sk-..." }
}

`cryptography` is already pinned to `44.0.3` inside the script's inline metadata, so no extra flags are needed even on hosts without a Rust toolchain (e.g. Intel Macs, where newer releases fall back to a source build and fail).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 99 lines
  1. # deepseek-search-mcp
  2. Minimal single-file MCP server exposing the [DeepSeek Web Search API](https://api-docs.deepseek.com/zh-cn/guides/search) (`POST /v1/tools/search`) over stdio.
  3. - **Single file** — `server.py` with inline [PEP 723](https://peps.python.org/pep-0723/) dependencies, nothing to install (`cryptography` is pinned to a prebuilt-friendly version so hosts without a Rust toolchain, e.g. Intel Macs, don't fail on source builds)
  4. - **One tool** — `web_search`, no config surface beyond one environment variable
  5. - **Drop-in friendly** — tool parameter names stay compatible with `mcp-server-askecho-search-infinity`, so prompts written for the retired server keep working
  6. - Runs via [`uv`](https://docs.astral.sh/uv/), even straight from a raw GitHub URL — no clone, no pip
  7. Not affiliated with DeepSeek. This is an independent community project.
  8. ## Setup
  9. 1. Get a DeepSeek API key from the [DeepSeek Open Platform](https://platform.deepseek.com/)
  10. 2. Point any stdio MCP client at `server.py` with `DEEPSEEK_API_KEY` set
  11. Search requests are billed to your own DeepSeek account (about 5 CNY per 1,000 successful requests; failed or empty-result requests are free).
  12. ### Client configuration
  13. Run-from-URL (no clone needed):
  14. ```json
  15. {
  16. "mcpServers": {
  17. "deepseek-web-search": {
  18. "command": "uv",
  19. "args": [
  20. "run",
  21. "https://raw.githubusercontent.com/haohaoo3o/deepseek-search-mcp/main/server.py"
  22. ],
  23. "env": { "DEEPSEEK_API_KEY": "sk-..." }
  24. }
  25. }
  26. }
  27. ```
  28. Or after cloning:
  29. ```json
  30. {
  31. "command": "uv",
  32. "args": ["run", "--no-project", "/absolute/path/to/deepseek-search-mcp/server.py"],
  33. "env": { "DEEPSEEK_API_KEY": "sk-..." }
  34. }
  35. ```
  36. `cryptography` is already pinned to `44.0.3` inside the script's inline metadata, so no extra flags are needed even on hosts without a Rust toolchain (e.g. Intel Macs, where newer releases fall back to a source build and fail).
  37. ## Tool: `web_search`
  38. | Parameter | Type | Default | Notes |
  39. |---|---|---|---|
  40. | `Query` | string | required | 1–128 chars; operators below are supported natively |
  41. | `Count` | int | 10 | 1–50 |
  42. | `SearchType` | string | `"web"` | only `web` is supported (DeepSeek has no image search) |
  43. | `NeedContent` | bool | `false` | include page content per result |
  44. | `NeedUrl` | bool | `true` | compatibility only; URLs are always returned |
  45. | `Sites` | string | `""` | pipe-separated allowlist → `site:` operators |
  46. | `BlockHosts` | string | `""` | pipe-separated blocklist → `-site:` operators |
  47. | `TimeRange` | string | `""` | `OneDay` / `OneWeek` / `OneMonth` / `OneYear` → `after:` date |
  48. | `AuthLevel` | int | 0 | `1` keeps only results with `authority >= 3` |
  49. | `Industry`, `QueryRewrite`, `ContentFormats` | — | — | accepted for compatibility, ignored |
  50. `Query` supports DeepSeek's search operators directly and they can be combined:
  51. `site:github.com`, `-site:example.com`, `"exact phrase"`, `-exclude`, `lang:zh,en`, `after:2026-01-01`, `before:2026-06-01`.
  52. ## Response
  53. ```json
  54. {
  55. "provider": "deepseek",
  56. "query": "mcp server example (site:github.com) after:2026-01-01",
  57. "count": 2,
  58. "results": [
  59. {
  60. "title": "...",
  61. "url": "https://...",
  62. "snippet": "short snippet",
  63. "summary": "longer summary",
  64. "content": "(empty unless NeedContent=true)",
  65. "site_name": "...",
  66. "date": "2026-07-28T00:00:00+00:00",
  67. "authority": 3,
  68. "rerank_score": 2.47
  69. }
  70. ]
  71. }
  72. ```
  73. Errors return `{"error": {"status": ..., "message": ...}}` instead of raising.
  74. ## Heavier alternative
  75. If you want fetch-to-Markdown, structured extraction, or cited deep research on top of the same API, look at [radoxtech/deepseek-search-everywhere-mcp](https://github.com/radoxtech/deepseek-search-everywhere-mcp) — a full-featured, MCP-Registry-listed server. This project intentionally stays single-file and single-tool for setups that only need a lightweight `web_search`.
  76. ## License
  77. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.