DeepSeek Web Search

mcp-deepseek-search

一个 Model Context Protocol 服务，可向任意 MCP 客户端（Claude Desktop、Claude Code、Cursor、Cline、ZCode 等）提供 DeepSeek 的网页 Search 和 Fetch 工具。

适用于任何大模型：搜索由 DeepSeek 自有的搜索引擎执行，结果则以普通工具输出的形式返回给你现有的模型。

功能

• deepseek_search ——由 DeepSeek 搜索引擎支持的网页搜索，每条结果附带两个质量指标：
  • rerank_score（0–3）：相关性；≥ 1.5 表示高度相关
  • authority（0–4，-1 表示未知）：来源权威性；≥ 3 表示权威性很高
• deepseek_fetch ——获取单个网页，并将其主要内容以 Markdown 格式返回
• 强大的查询语法：site:、-site:、-term、"exact phrase"、-"phrase"、lang:zh,en、after:YYYY-MM-DD、before:YYYY-MM-DD
• 内置限流（将请求频率控制在账号限制 5 QPS 以下），并在出现 408/429/5xx 时自动重试
• 注重响应大小：默认返回摘要，仅在请求时返回完整网页文本

设置

1. 在 platform.deepseek.com 获取 API 密钥（网页工具的费用为每 1,000 次成功调用 ¥5，从你的 DeepSeek 账户扣除；失败的调用和空结果不收费）。
2. 将服务添加到 MCP 客户端配置中：

Claude Desktop / Cursor / Cline / 大多数客户端

{
  "mcpServers": {
    "deepseek-web": {
      "command": "npx",
      "args": ["-y", "mcp-deepseek-search"],
      "env": {
        "DEEPSEEK_API_KEY": "sk-your-key-here"
      }
    }
  }
}

ZCode

将相同的 mcpServers 代码块添加到 ZCode MCP 设置中（Settings → MCP → Add server）。

从源代码运行

git clone https://github.com/Matthewyin/deepseek-mcp
cd deepseek-mcp && npm install && npm run build
node dist/index.js   # stdio MCP server

工具

deepseek_search

参数	类型	必填	描述
query	字符串	是	1–128 个字符；支持上述搜索语法
count	整数	否	1–50 条结果，默认值为 10（不影响计费）
ori_question	字符串	否	用户的原始问题——当查询经过改写时，可提升意图匹配效果
localization	字符串	否	用于本地化结果的用户 IP（仅在获得同意后传入）
need_content	布尔值	否	是否包含每条结果的完整网页文本（每条最多截断至 8,000 个字符）。默认值为 false

每条结果包含 title、url、snippet（简短，供展示）、summary（较长，供模型使用）、rerank_score、authority、site_name、date，以及可选的 content。

deepseek_fetch

参数	类型	必填	描述
url	字符串	是	普通 http(s) URL，最多 8,192 个字符，不得包含嵌入式凭据

返回 title 和 Markdown 格式的 content（最多截断至 30,000 个字符）。

示例

向你的 Agent 提问：“用 deepseek_search 搜一下最近一周关于 MCP 的大新闻，挑权威来源，再用 deepseek_fetch 读全文总结”——或用英文提问：“搜索近期 DeepSeek 新闻，仅保留 authority ≥ 3 的结果，获取排名第一的结果并进行总结。”

说明与限制

• 速率限制为每个 DeepSeek 账户 5 QPS（所有 API 密钥共享）；服务会自动限流。
• HTTP 402 表示 DeepSeek 账户余额不足；401 表示密钥无效。
• 网页内容取决于目标网站的可用性和访问策略。
• 这是非官方的社区封装项目，与 DeepSeek 无关。

开发

npm install
npm run build
DEEPSEEK_API_KEY=sk-... npm test   # end-to-end test against the real API

通过 GitHub Actions 自动发布：推送 v* 标签后，会发布到 npm 和官方 MCP Registry。

许可证

MIT