{"_id":"mcp-deepseek-search","_rev":"4-020f27a5ca88ef396c68621b85c4fb3e","name":"mcp-deepseek-search","dist-tags":{"latest":"1.1.0"},"versions":{"0.0.0-stage":{"name":"mcp-deepseek-search","version":"0.0.0-stage","_id":"mcp-deepseek-search@0.0.0-stage","stub":true,"maintainers":[{"name":"alkaidy","email":"tccio2023@gmail.com"}],"dist":{"shasum":"528882a7dcfdf6091db0044502ef8aed64123919","tarball":"https://registry.npmjs.org/mcp-deepseek-search/-/mcp-deepseek-search-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-AUqqkQon5Sl4BWq2b5DSr0dVdFWPx3gZe0ogVz/G5biGAbDA1Ql55mssj6I5gVOLF4nFJAJ4fdEOcohwyybAqA==","signatures":[{"sig":"MEQCIEB4xNLfKZNvXp9WWmHWdwc4cbMpEAfRYQn4SnlVCygrAiBdC6PxkeySBOwX74jTkAQAD3A4lBxevclmCGKXDWz0+A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":341},"_npmUser":{"name":"alkaidy","email":"tccio2023@gmail.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"1.0.0":{"name":"mcp-deepseek-search","version":"1.0.0","keywords":["mcp","model-context-protocol","deepseek","web-search","search","fetch","claude","cursor","cline"],"license":"MIT","_id":"mcp-deepseek-search@1.0.0","maintainers":[{"name":"alkaidy","email":"tccio2023@gmail.com"}],"homepage":"https://github.com/Matthewyin/deepseek-mcp#readme","bugs":{"url":"https://github.com/Matthewyin/deepseek-mcp/issues"},"bin":{"mcp-deepseek-search":"dist/index.js"},"dist":{"shasum":"f8e040087af11074ab8e5f60613a1061d769a0bf","tarball":"https://registry.npmjs.org/mcp-deepseek-search/-/mcp-deepseek-search-1.0.0.tgz","fileCount":5,"integrity":"sha512-EouSIxt1ikEz7M+5TtLhdp/vKpkQzITNDAioZr9RDD4cyrJyHqAm/FMBJmPy6eYcPyvlXHGBZyYcbQuRstNkEA==","signatures":[{"sig":"MEQCIA+O7tlRjFXK65ff0RNRbP7ZhnpwsZCAv2du7vcqbdw+AiBPMSYjANv1CrSPMO3voJY+d/A76BAT/w53kGEzXkkMiQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDo8MX/Arz9NaX04I272RatWZz0PGd9Mn7dyCpnJ+UIrgIgYAyYJvFAM66wIODxEqilB+xBp3Db5Oks6GQvXnuIkXo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16900},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"693ce799896e0ba7053c0183d925c221d2e7c6a0","scripts":{"test":"node test/e2e.mjs","build":"tsc","prepare":"npm run build"},"_npmUser":{"name":"alkaidy","email":"tccio2023@gmail.com"},"repository":{"url":"git+https://github.com/Matthewyin/deepseek-mcp.git","type":"git"},"_npmVersion":"12.2.1","description":"MCP server exposing DeepSeek's web Search & Fetch tools — web search with rerank/authority scoring and page-to-Markdown fetching, for Claude Desktop, Cursor, Cline, ZCode and any MCP client.","directories":{},"_nodeVersion":"22.23.1","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.32.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.0","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-deepseek-search_1.0.0_1792849730606_0.38655553136274245","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"mcp-deepseek-search","version":"1.0.1","keywords":["mcp","model-context-protocol","deepseek","web-search","search","fetch","claude","cursor","cline"],"license":"MIT","_id":"mcp-deepseek-search@1.0.1","maintainers":[{"name":"alkaidy","email":"tccio2023@gmail.com"}],"homepage":"https://github.com/Matthewyin/deepseek-mcp#readme","bugs":{"url":"https://github.com/Matthewyin/deepseek-mcp/issues"},"bin":{"mcp-deepseek-search":"dist/index.js"},"dist":{"shasum":"f1c9621fab6d3d2584d8c5219272295537a3d2f3","tarball":"https://registry.npmjs.org/mcp-deepseek-search/-/mcp-deepseek-search-1.0.1.tgz","fileCount":5,"integrity":"sha512-I/6Ehs+i52jK+8u/o9kjFNu6ZwuAOmbvQ57QyoVjzmDkfZ+pf3af8pBsUfr2EpO5cFr3Mxa6yeBkXvV3ei9LWQ==","signatures":[{"sig":"MEQCIE0rgQDIozIWJR24RSC2VeKsTf8FCq0xRUTWCmrXG1thAiACB60pHXo/gF3xkkxYmAk016faBEorJhyNbeOx3HI/yQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCYI6TC+ghCPW/y/ZqxVk+ymt7t3b1nl0xxL9C5B4gnrAIhAM/U8zt6yUO39MiKDaNTagZvv+7BXApkAXVjO7b2tVZm","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16950},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"693ce799896e0ba7053c0183d925c221d2e7c6a0","mcpName":"io.github.Matthewyin/deepseek-mcp","scripts":{"test":"node test/e2e.mjs","build":"tsc","prepare":"npm run build"},"_npmUser":{"name":"alkaidy","email":"tccio2023@gmail.com"},"repository":{"url":"git+https://github.com/Matthewyin/deepseek-mcp.git","type":"git"},"_npmVersion":"12.2.1","description":"MCP server exposing DeepSeek's web Search & Fetch tools — web search with rerank/authority scoring and page-to-Markdown fetching, for Claude Desktop, Cursor, Cline, ZCode and any MCP client.","directories":{},"_nodeVersion":"22.23.1","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.32.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.0","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-deepseek-search_1.0.1_1792850172062_0.38729617119757287","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"_id":"mcp-deepseek-search@1.1.0","bin":{"mcp-deepseek-search":"dist/index.js"},"bugs":{"url":"https://github.com/Matthewyin/deepseek-mcp/issues"},"dist":{"shasum":"eceb7b46c09cced908e2c06ceb5e74f01fe0bddc","tarball":"https://registry.npmjs.org/mcp-deepseek-search/-/mcp-deepseek-search-1.1.0.tgz","fileCount":5,"integrity":"sha512-GVA6rgquRsHtmQzZh0X1MddPjiCcLavx3g3zrEgPyXsVuei3t71Kl9xUtjFQ724P9x64wwPdCwEE1AZ0+0734w==","signatures":[{"sig":"MEUCIGZV4X0rLWxgClHLGLCXh24OVL5IAA3vQ+yFvnO12gqQAiEAiL8O+DwaTF+Abwhy5jJS148DNXIkhxnz5dBuJmAMetY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC4y/NX5Fc+udWZUIdGSylBwvwMuFDIX6jtGefYac8/eAIgLPfJ5HbdDJIQgFxwnfPoP3HBAeyqa2Mr3puaylTl8IQ="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/mcp-deepseek-search@1.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":24440},"main":"dist/index.js","name":"mcp-deepseek-search","type":"module","engines":{"node":">=18"},"gitHead":"415913b087e908786bc0121c725349057088c2d4","license":"MIT","mcpName":"io.github.Matthewyin/deepseek-mcp","scripts":{"test":"node test/e2e.mjs","build":"tsc","prepare":"npm run build"},"version":"1.1.0","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"57faa4f9-8aab-4b84-a19a-33161539490a"}},"homepage":"https://github.com/Matthewyin/deepseek-mcp#readme","keywords":["mcp","model-context-protocol","deepseek","web-search","search","fetch","claude","cursor","cline"],"repository":{"url":"git+https://github.com/Matthewyin/deepseek-mcp.git","type":"git"},"_npmVersion":"11.19.1","description":"MCP server exposing DeepSeek's tools — web Search with rerank/authority scoring, page-to-Markdown Fetch, plus OCR, ASR and TTS — for Claude Desktop, Cursor, Cline, ZCode and any MCP client.","directories":{},"maintainers":[{"name":"alkaidy","email":"tccio2023@gmail.com"}],"_nodeVersion":"24.22.2","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.32.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.0","@types/node":"^22.10.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-deepseek-search_1.1.0_1794587318928_0.11185523645378859"}}},"time":{"created":"2026-10-24T13:47:54.681Z","modified":"2026-11-13T16:28:39.395Z","0.0.0-stage":"2026-10-24T13:47:54.681Z","1.0.0":"2026-10-24T13:48:50.692Z","1.0.1":"2026-10-24T13:56:12.146Z","1.1.0":"2026-11-13T16:28:39.041Z"},"bugs":{"url":"https://github.com/Matthewyin/deepseek-mcp/issues"},"license":"MIT","homepage":"https://github.com/Matthewyin/deepseek-mcp#readme","keywords":["mcp","model-context-protocol","deepseek","web-search","search","fetch","claude","cursor","cline"],"repository":{"url":"git+https://github.com/Matthewyin/deepseek-mcp.git","type":"git"},"description":"MCP server exposing DeepSeek's tools — web Search with rerank/authority scoring, page-to-Markdown Fetch, plus OCR, ASR and TTS — for Claude Desktop, Cursor, Cline, ZCode and any MCP client.","maintainers":[{"name":"alkaidy","email":"tccio2023@gmail.com"}],"readme":"# mcp-deepseek-search\n\n[![npm version](https://img.shields.io/npm/v/mcp-deepseek-search.svg)](https://www.npmjs.com/package/mcp-deepseek-search)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![MCP Registry](https://img.shields.io/badge/MCP_Registry-io.github.Matthewyin-blue)](https://registry.modelcontextprotocol.io)\n\nAn [Model Context Protocol](https://modelcontextprotocol.io) server that exposes [DeepSeek's web **Search**, **Fetch**, **OCR**, **ASR** and **TTS** tools](https://api-docs.deepseek.com/zh-cn/api/search) to any MCP client — Claude Desktop, Claude Code, Cursor, Cline, ZCode, and more.\n\nWorks with **any** LLM: the tools run on DeepSeek's APIs, but the results are returned to your existing model as ordinary tool output.\n\n## Features\n\n- **`deepseek_search`** — web search backed by DeepSeek's search engine, with two quality signals per result:\n  - `rerank_score` (0–3): relevance; **≥ 1.5 = highly relevant**\n  - `authority` (0–4, `-1` unknown): source authority; **≥ 3 = highly authoritative**\n- **`deepseek_fetch`** — fetch a single page and get its main content as Markdown\n- **`deepseek_ocr`** — extract text from PDF / Word / PPT / images (incl. scanned pages), per page\n- **`deepseek_asr`** — transcribe 16-bit PCM WAV or Ogg Opus audio to text\n- **`deepseek_tts`** — synthesize speech (`stella` female / `tide` male) to a local wav/pcm file\n- Powerful query syntax: `site:`, `-site:`, `-term`, `\"exact phrase\"`, `-\"phrase\"`, `lang:zh,en`, `after:YYYY-MM-DD`, `before:YYYY-MM-DD`\n- Built-in throttling (stays under the 5 QPS account limit) and automatic retry on 408/429/5xx\n- Response-size friendly: summaries by default, full page text only on request\n\n## Setup\n\n1. Get an API key at [platform.deepseek.com](https://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).\n2. Add the server to your MCP client config:\n\n### Claude Desktop / Cursor / Cline / most clients\n\n```json\n{\n  \"mcpServers\": {\n    \"deepseek-web\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-deepseek-search\"],\n      \"env\": {\n        \"DEEPSEEK_API_KEY\": \"sk-your-key-here\"\n      }\n    }\n  }\n}\n```\n\n### ZCode\n\nAdd the same `mcpServers` block to your ZCode MCP settings (Settings → MCP → Add server).\n\n### From source\n\n```bash\ngit clone https://github.com/Matthewyin/deepseek-mcp\ncd deepseek-mcp && npm install && npm run build\nnode dist/index.js   # stdio MCP server\n```\n\n## Tools\n\n### `deepseek_search`\n\n| Parameter | Type | Required | Description |\n|---|---|---|---|\n| `query` | string | yes | 1–128 chars; supports the search syntax above |\n| `count` | integer | no | 1–50 results, default 10 (does not affect billing) |\n| `ori_question` | string | no | The user's original question — improves intent matching when the query was rewritten |\n| `localization` | string | no | User IP to localize results (pass only with consent) |\n| `need_content` | boolean | no | Include full page text per result (each truncated at 8,000 chars). Default `false` |\n\nEach result includes `title`, `url`, `snippet` (short, for display), `summary` (long, for feeding to a model), `rerank_score`, `authority`, `site_name`, `date`, and optionally `content`.\n\n### `deepseek_fetch`\n\n| Parameter | Type | Required | Description |\n|---|---|---|---|\n| `url` | string | yes | Plain `http(s)` URL, max 8,192 chars, no embedded credentials |\n\nReturns `title` + Markdown `content` (truncated at 30,000 chars).\n\n### `deepseek_ocr`\n\n| Parameter | Type | Required | Description |\n|---|---|---|---|\n| `file_path` | string | yes | Local path to a PDF, Word, PowerPoint or image file |\n| `purpose` | string | no | `text_recognition` (default) or `rich_layout_recognition` (page-by-page layout-aware recognition) |\n\nReturns per-page `text` (each page truncated at 8,000 chars) with `page_count` and `finish_reason` per page.\n\n### `deepseek_asr`\n\n| Parameter | Type | Required | Description |\n|---|---|---|---|\n| `file_path` | string | yes | Local path to 16-bit PCM WAV or Ogg Opus audio |\n\nReturns `text` and `duration_ms`.\n\n### `deepseek_tts`\n\n| Parameter | Type | Required | Description |\n|---|---|---|---|\n| `text` | string | yes | The text to speak |\n| `voice_id` | string | no | `stella` (female, default) or `tide` (male) |\n| `format` | string | no | `wav` (default) or raw `pcm` (24 kHz, 16-bit signed, mono) |\n| `output_path` | string | no | Where to write the audio file; defaults to a temp file. The resolved path is returned |\n\n## Example\n\nAsk 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.\"*\n\n## Notes & limits\n\n- Rate limit is **5 QPS per DeepSeek account** (shared across all your API keys); the server throttles automatically.\n- HTTP 402 means your DeepSeek balance ran out; 401 means the key is invalid.\n- Page content depends on the target site's availability and access policy.\n- OCR / ASR / TTS have their own file-format and billing rules — see the [API docs](https://api-docs.deepseek.com/zh-cn/api/ocr) for details.\n- This is an unofficial community wrapper; not affiliated with DeepSeek.\n\n## Development\n\n```bash\nnpm install\nnpm run build\nDEEPSEEK_API_KEY=sk-... npm test   # end-to-end test against the real API\n```\n\nReleases are automated via GitHub Actions: pushing a `v*` tag publishes to npm and the official MCP Registry.\n\n## License\n\n[MIT](LICENSE)\n","readmeFilename":"README.md"}