DeepSeek Search / Fetch MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
DeepSeek Search / Fetch MCP
供同一台电脑上的 Codex、Claude Code、Hermes Agent、DeepSeek Harness、OpenCode 等 MCP 客户端调用的本地搜索服务。直接使用 DeepSeek 官方 Search / Fetch 接口,执行搜索的 Agent 自己阅读资料、组织答案,不需要把任务再交给 DeepSeek 聊天模型。
第一次使用
双击本目录的
configure.cmd,在隐藏输入框中填入你自己的 DeepSeek 官方平台 API Key。程序使用 Windows DPAPI 加密后保存到
%APPDATA%\deepseek-search-mcp\config.json。同一 Windows 用户下的所有客户端共用这一份配置。不要把密钥发到聊天里。配置程序自动通过 MCP 做一次 Search 和一次 Fetch 联网验证,最多产生两次成功请求,按当前价格合计约 0.01 元人民币。配置完成后重新打开各 Agent 的会话;有 MCP 重连功能的客户端也可单独重连。
注册器会在本机生成 registration-report.json,记录实际注册的客户端及原配置备份路径;该文件已被 Git 忽略,不应提交。只创建已有客户端配置对应的条目。DeepSeek Harness 写入 home 级 ~/.dsh/cordis.patch.yml,因此适用于它的所有 profile;OpenCode 2 使用 mcp.servers 格式。其他支持标准 MCP 的软件可导入 client-configs/standard-mcp.json,或复制其中的 command 与 args,并把示例中的占位路径改为本地克隆目录。已有配置应合并服务器条目,不要用示例覆盖整个文件。
Hermes 按实际 HERMES_HOME 定位配置。本机使用 %LOCALAPPDATA%\hermes\config.yaml;当前 Windows 版未指定 HERMES_HOME 时也默认使用此目录。其它 Hermes profile 需要在其配置中引用同一组 command / args,密钥继续共用。
Related MCP server: deepseek-search-mcp
兼容方式
使用标准 MCP stdio + JSON-RPC;各客户端按需启动同一份 Node.js 程序。
工具仅依赖 MCP Tools,不要求客户端支持 Resources、Prompts、浏览器、模型插件或特定 UI。
每个客户端有自己的子进程,共用代码与密钥;无需常驻后台进程或本地 HTTP 端口。
工具同时返回
content[].text与structuredContent,兼容读取文本的客户端和支持结构化结果的客户端。stdout 只输出 MCP 消息;API Key 不进入工具参数、工具结果或日志。服务端不会把上游错误正文直接转发给模型。
Node.js 22 或更新版本;当前机器为 Node.js 26。依赖已安装,版本由
package-lock.json固定。
密钥选择顺序是进程环境变量 DEEPSEEK_API_KEY,然后本地 DPAPI 配置;环境变量适用于其他操作系统。DPAPI 配置只能由保存它的 Windows 用户解密。DEEPSEEK_MCP_CONFIG 可以指定另一份配置文件。修改加密配置后,正在运行的服务会在下一次请求时重新读取。
工具
工具 | 用途 | 默认输出控制 |
| 搜索互联网,返回 URL、日期、短摘要、长摘要、权威度和可用正文 | 5 条结果;带正文;单条正文最多 4,000 字符,总正文最多 16,000 字符 |
| 读取一个 HTTP/HTTPS URL,返回 Markdown 正文 | 单次最多 30,000 字符;可指定起点和长度 |
| 检查本地密钥配置 | 不发送联网请求,不验证余额,不返回密钥 |
搜索示例:
{
"query": "DeepSeek site:deepseek.com after:2026-10-01",
"count": 5,
"need_content": true,
"max_content_chars": 4000,
"max_total_content_chars": 16000
}只需要寻找链接和摘要时,设置 need_content: false。需要长文时调大正文预算,上限为单条 100,000 字符、全部正文 200,000 字符。摘要和元数据不计入正文预算;上游返回它们的长度也会影响模型输入 token 数量。
抓取示例:
{
"url": "https://api-docs.deepseek.com/zh-cn/guides/search",
"start_char": 0,
"max_chars": 30000
}输出中的 content_length 是该次上游响应正文的完整 Unicode 字符数,returned_characters 是本次返回数,truncated 表示只返回了窗口,next_start_char 指向后续窗口。字符按 Unicode 码点计数,避免截断 emoji 的代理对。返回窗口只是原始内容的一段,不会重写正文或删除 Markdown 转义符。
每次 Fetch 窗口调用都会重新请求上游,可能再次计费,而且内容可能变化。本服务不缓存响应;读取长文时可一次调大 max_chars,然后由 Agent 保存、分析结果。
接口与计费
项目 | 当前规则 |
搜索 |
|
抓取 |
|
官方价格 | Search / Fetch 各每 1,000 次成功请求 5 元人民币,美元文档为 0.75 美元 |
成功条件 | Search 返回非空结果;Fetch 返回正文;均要求 HTTP 200 |
搜索词上限 | 128 个 Unicode 字符,包含搜索算子在内 |
原生算子 |
|
当前官方账号限额 | Search 100 QPS,Fetch 25 QPS,另有目标域名限额 |
日期过滤推荐写完整日期,例如 after:2026-01-01。服务不会自行改写搜索词、语言或过滤条件。权威度和相关性评分原样保留,不据此自动丢弃长尾结果。
每次请求从排队起最多 45 秒,支持 MCP 取消。单进程最多同时执行 4 个 Search 和 2 个 Fetch;其他客户端的子进程不共享此队列,最终账号限额仍由 DeepSeek 控制。明确收到 HTTP 408、429 或 5xx 时最多重试一次;401、402、403、404 不重试;连接中断、超时和不合法的 HTTP 200 响应不自动重试,以减少重复计费。遵守 Retry-After,等待时间超过 5 秒则直接返回错误,由调用方决定后续处理。
网页可用性以实际返回为准。content 有值、返回 HTTP 200 或正文较长,都不能用来判断是否已获得完整的订阅文章;工具会保留原始来源与截断信息供核对。
检查、重装与注册
在本目录运行:
npm run status
npm test
npm run check:livestatus 不联网;test 使用 mock 和虚构测试密钥,不调用付费接口;check:live 使用已配置的真实密钥,通过 MCP 发起两次官方 API 调用。测试还在安装了 DeepSeek Harness 时使用它实际携带的 MCP 客户端 SDK 验证互通。
迁移到另一位置或另一台电脑后,先运行 npm ci --ignore-scripts。然后运行 node scripts/register.mjs 预览配置变更,运行 node scripts/register.mjs --apply 注册。已有同名条目会跳过;若目录移动,需要先移除对应客户端的旧 deepseek-search 条目,再注册新的路径。Windows 密钥需要重新运行 configure.cmd 保存。
注册器会备份原文件,只增加服务器配置,不修改 Agent 的模型选择、搜索默认规则或 skill。撤销时从客户端中删除 deepseek-search 条目;Harness 删除 id: mcp-deepseek-search 对应的 insert 块。若注册之后还修改过其它配置,建议只删除这一条,而非恢复整个旧备份。
来源
接口、计费与兼容文档核对日期:2026-11-16。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Web search API and MCP server for developers building AI agents.
Scrape, crawl and search the web for AI agents via MCP.
Free web search for AI agents. No API key required. Hosted MCP in active development.
Live AI-native web search with citations. One tool for every MCP client. Flat per-request pricing.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables MCP clients to run web searches via DeepSeek's open platform API, with optional web page fetching that returns Markdown content, and supports query syntax for source, language, and time filters.174 npm1MIT
- AlicenseAqualityCmaintenanceEnables MCP clients to run web searches and fetch web page contents through DeepSeek's Search and Fetch APIs, returning structured JSON results with configurable tool names and multiple transport options.211MIT
- AlicenseAqualityCmaintenanceEnables MCP clients to perform web searches and fetch HTTP(S) pages as Markdown through Search and Fetch APIs.264 npmMIT
- AlicenseAqualityCmaintenanceEnables web search and page fetching through the DeepSeek Search and Fetch APIs, exposing search and fetch tools to MCP clients. Supports paginated content retrieval with cursors so long pages can be read in chunks without repeating upstream requests.2AGPL 3.0