DeepSeek Search MCP
This server provides a local stdio MCP endpoint that uses the DeepSeek API to search the web (and optionally fetch pages), returning structured results to an MCP client.
Web search via
deepseek_search: run a query and get a ranked list of structured results.Result count control: return between 1 and 50 results per query (default 10).
Search operators / syntax: supports
site:,-site:, exact"..."phrases,-"..."exclusions,-termexclusions,lang:codes, andafter:/before:date filters, combined freely, forwarded with syntax intact.Localization: optionally pass an IP address to localize results.
Content retrieval option: request page
contentvianeed_content(defaults false, content empty otherwise).Query context: optional
ori_question(the user's original question) to improve query understanding.Optional web fetch:
deepseek_web_fetch(mapped to DeepSeek's fetch API) is available only whenDEEPSEEK_ENABLE_WEB_FETCH="true"; it is off by default and then absent from the client's tool list.Requirements: needs a
DEEPSEEK_API_KEY, Node.js 22+, and consumes DeepSeek account credits; stdio transport only.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@DeepSeek Search MCP search for the latest DeepSeek news site:deepseek.com lang:en after:2026-01-01"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
DeepSeek Search MCP
非官方的本地 MCP Server,使用 DeepSeek 开放平台 API Key 调用联网搜索和网页抓取接口。仅支持 stdio。
环境要求
Node.js 22 或更新版本
npm
DeepSeek 开放平台 API Key,可在 API Key 管理页面创建
Related MCP server: DeepSeek Search MCP
安装与启动
推荐使用 npm 全局安装,适合日常使用,启动开销较低且无需自行构建。npx 配置方便,适合快速试用,但启动开销较高;源码构建适合需要修改代码的用户。
以下以 DeepSeek Harness (DSH) 为例,将配置合并到用户级 ~/.dsh/cordis.patch.yml,替换 API Key 占位符。
保存配置后,若配置变更未生效,工具未出现在 MCP 列表中,可尝试重启客户端。
npm 全局安装(推荐)
npm install -g deepseek-search-mcp@latest安装完成后,使用以下启动配置:
Windows:
- insert: - id: mcp-deepseek-search name: '@deepseek-ai/dsh-mcp-client' config: serverName: deepseek-search transport: stdio command: cmd args: ['/c', 'deepseek-search-mcp'] env: DEEPSEEK_API_KEY: 'YOUR_DEEPSEEK_API_KEY' DEEPSEEK_ENABLE_WEB_FETCH: 'false' toolCallTimeoutMs: 80000macOS / Linux:
- insert: - id: mcp-deepseek-search name: '@deepseek-ai/dsh-mcp-client' config: serverName: deepseek-search transport: stdio command: deepseek-search-mcp args: [] env: DEEPSEEK_API_KEY: 'YOUR_DEEPSEEK_API_KEY' DEEPSEEK_ENABLE_WEB_FETCH: 'false' toolCallTimeoutMs: 80000
npx 快速试用
无需全局安装或自行编译,配置方便,但启动开销高于全局安装。
Windows:
- insert: - id: mcp-deepseek-search name: '@deepseek-ai/dsh-mcp-client' config: serverName: deepseek-search transport: stdio command: cmd args: ['/c', 'npx', '-y', 'deepseek-search-mcp@latest'] env: DEEPSEEK_API_KEY: 'YOUR_DEEPSEEK_API_KEY' DEEPSEEK_ENABLE_WEB_FETCH: 'false' toolCallTimeoutMs: 80000macOS / Linux:
- insert: - id: mcp-deepseek-search name: '@deepseek-ai/dsh-mcp-client' config: serverName: deepseek-search transport: stdio command: npx args: ['-y', 'deepseek-search-mcp@latest'] env: DEEPSEEK_API_KEY: 'YOUR_DEEPSEEK_API_KEY' DEEPSEEK_ENABLE_WEB_FETCH: 'false' toolCallTimeoutMs: 80000
首次启动需要联网下载包。
从源码构建
从 GitHub 仓库 下载源码,在项目根目录执行:
npm ci
npm run build构建产物位于 dist。将下方配置合并到客户端的 MCP 配置中,替换 API Key 占位符,并将 args 中的路径改为 dist/index.js 的实际绝对路径:
- insert:
- id: mcp-deepseek-search
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: deepseek-search
transport: stdio
command: node
args: ['C:/path/to/deepseek-search-mcp/dist/index.js']
env:
DEEPSEEK_API_KEY: 'YOUR_DEEPSEEK_API_KEY'
DEEPSEEK_ENABLE_WEB_FETCH: 'false'
toolCallTimeoutMs: 80000工具
搜索支持站点、语言和时间范围筛选。完整参数和搜索语法见 DeepSeek 联网搜索指南及上方接口文档。
环境变量
变量 | 规则 |
| 必填,使用 DeepSeek 开放平台 API Key |
| 控制是否启用 |
考虑到不少 Agent 软件已经自带网页抓取(web_fetch)功能,需要付费使用的 deepseek_web_fetch 工具默认关闭,也不会出现在客户端的工具列表中。需要时,可将 DEEPSEEK_ENABLE_WEB_FETCH 设置为 "true" 来开启。
费用
调用使用 DeepSeek 开放平台账户额度。具体价格和计费规则见 DeepSeek 联网搜索指南。
许可证
MIT,Copyright (c) 2026 Caelix。
Available Tools
1 tooldeepseek_searchC
Search the web for a query and return a ranked list of structured results.
Inputs: query (required), count, localization, need_content, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With a single tool there is no possibility of misselection or overlap; its purpose is unambiguous. The name and description align cleanly, leaving nothing to confuse.
The lone tool uses a clear snake_case verb_noun style (deepseek_search) that matches its server identity. No mixed conventions exist since there is only one name.
A one-tool surface is borderline thin even for a search server; typical search MCPs expose pagination, filtering, or multiple content types. It works but leaves little room for user control.
Core web search is covered, but there are no options for result count, pagination, freshness, or filtering, which are common expectations. The surface is functional yet notably shallow for a search domain.
Maintenance
Related MCP Connectors
Web search, scraping, RAG answers with citations, and translation as MCP tools.
Live AI-native web search with citations. One tool for every MCP client. Flat per-request pricing.
Scrape, crawl and search the web for AI agents via MCP.
Web search API and MCP server for developers building AI agents.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables MCP-capable AI clients to run web searches through DeepSeek's search engine and fetch individual webpages as Markdown. Search results include relevance scores, authority, and publication times, and support advanced query syntax such as site:, lang:, and date filters.287 npmApache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to run web searches and fetch individual web pages as Markdown through DeepSeek's official Search/Fetch API, with freshness filtering, structured metadata such as publish date, authority and rerank scores, and raw structured output.87 npm2MIT
- AlicenseAqualityCmaintenanceEnables MCP clients to run ranked web searches with DeepSeek's search operators and to retrieve pages as titles and Markdown through DeepSeek's official Search and Fetch APIs, without invoking a chat model. Results are returned as structured content plus matching JSON text, with options for result count, page content, localization, and original-question context.250 npm3MIT
- AlicenseAqualityCmaintenanceExposes DeepSeek's web search and page-fetch tools to any MCP client, letting any LLM run searches with quality signals like rerank score and source authority, plus advanced query syntax. It also retrieves single pages as Markdown, with built-in throttling, retries, and size-conscious summaries.2101 npm2MIT