AI Search MCP

专为 Agent 打造的上网搜索 MCP 服务器：开箱即用的免费搜索引擎、可插拔的高质量引擎、内置缓存、时间过滤，以及一次调用完成整轮调研的 research 组合工具。

An agent-friendly web search MCP server — zero-config free engines, region-aware failover, freshness filtering, and a one-call research tool.

为什么做这个（Why）

搜索是 Agent 最高频的工具，但现有方案都有硬伤：

ai-search-mcp 填补了这个空档：零配置就能用（DuckDuckGo / Bing / 百度 / 搜狗），自动按区域选择最合适的引擎并故障转移，支持时效过滤，还能把「搜→选→抓→总结」的整轮调研压成一次 research 调用。

Related MCP server: websearch-skill

特性（Features）

• 🆓 零配置开箱即用：npx ai-search-mcp 直接跑，不需要任何 API Key

• 🔌 多引擎可插拔：免费引擎 duckduckgo · bing · baidu · sogou + 付费引擎 brave · tavily

• 🌏 区域感知自动选引擎：SEARCH_ENGINE=auto（默认）→ 中国区域走 bing→baidu→sogou，其他区域走 duckduckgo→bing；429/超时自动故障转移，支持逗号分隔引擎链

• 🕒 时间过滤：freshness=day|week|month|year 或 timeRange="YYYY-MM-DD..YYYY-MM-DD"，按引擎自动映射

• 🧠 Agent 友好输出：结构化 JSON（{ id, title, url, snippet, domain }），不是原始 HTML；每条结果带稳定 id，可直接引用

• 🧭 research 组合工具：一次调用 = 搜索 + 抓取 Top 页 → 证据简报（消灭 5~10 次工具往返）

• ⚡ 内置缓存（TTL，默认 10 分钟）：减少重复网络请求，更快更省

• 🛡️ 工程兜底：超时、指数退避重试、统一错误码，RATE_LIMITED 错误附带 suggestedEngine / retryAfter 建议

• 🐢 礼貌爬虫内置：按引擎限频（默认 8 次/分）+ 随机请求间隔，主动避免触发平台风控，不做任何反爬对抗（合规优先）

• 📄 fetch_page 工具：任意 URL（或搜索结果 id）转成可读 Markdown

• 🌏 代理支持：SEARCH_HTTP_PROXY / HTTP(S)_PROXY

• 🧪 零构建纯 JS（CommonJS），130 个单元测试 + 端到端冒烟测试

快速开始（Quick Start）

需要 Node.js >= 18。

# 直接用 npx 运行（无需安装）
npx -y ai-search-mcp

# 或全局/本地安装
npm i -g ai-search-mcp
ai-search-mcp

Claude Desktop

在 claude_desktop_config.json 中加入：

{
  "mcpServers": {
    "ai-search-mcp": {
      "command": "npx",
      "args": ["-y", "ai-search-mcp"]
    }
  }
}

Cursor / Cline / 其他支持 MCP 的客户端

{
  "mcpServers": {
    "ai-search-mcp": {
      "command": "npx",
      "args": ["-y", "ai-search-mcp"],
      "env": {
        "SEARCH_REGION": "cn-zh"
      }
    }
  }
}

中国用户建议加上 SEARCH_REGION=cn-zh，会自动走国内可直连的引擎链（bing → baidu → sogou），免代理。

从源码运行

git clone https://github.com/zhulingyu666/ai-search-mcp.git
cd ai-search-mcp
npm install
npm start

工具说明（Tools）

search — 搜索

{
  "query": "2026年 大模型 最新进展",
  "maxResults": 10,
  "site": "github.com",
  "region": "us-en",
  "freshness": "week"
}

返回（结构化 JSON）：

{
  "query": "2026年 大模型 最新进展",
  "queryRewritten": "大模型 最新进展",
  "queryYear": 2026,
  "engine": "bing",
  "engineSwitched": false,
  "cached": false,
  "total": 10,
  "deduped": 2,
  "freshnessApplied": true,
  "freshnessAutoInferred": true,
  "timeRange": "2025-08-25..2026-08-25",
  "results": [
    {
      "id": "a1b2c3d4",
      "title": "...",
      "url": "https://...",
      "snippet": "...",
      "domain": "example.com"
    }
  ]
}

中文查询自动改写：当查询含中文且出现「20xx年」年份词（如「2026年 大模型 最新进展」）时，工具会移除年份词并自动附加 freshness=year 补偿时间意图——因为 Bing 等引擎对中文分词弱，年份前缀会导致返回「2026年百科/日历」等跑题结果。改写通过 queryRewritten / queryYear / freshnessAutoInferred 透明返回，Agent 可自行判断是否接受。

每条结果带稳定 id（sha1 前缀）。把这个 id 传给 fetch_page 即可深读该页，无需再手拼 URL。

research — 一次调用完成整轮调研

替代 Agent「搜索 → 选页 → 抓取 → 总结」的循环，一次调用搞定：

{
  "query": "2026 LLM open source models comparison",
  "maxResults": 5,
  "fetchTopN": 2,
  "freshness": "month"
}

返回证据简报（evidence brief）：

{
  "query": "...",
  "engine": "bing",
  "overview": { "total": 5, "results": [ { "id": "...", "title": "...", "url": "...", "snippet": "...", "domain": "..." } ] },
  "pages": [ { "id": "...", "url": "...", "title": "...", "headings": [ { "level": 1, "text": "..." } ], "content": "...", "length": 4000, "truncated": false } ],
  "note": "证据简报已就绪，请基于页面内容总结并标注来源 URL。"
}

• 多页面并行抓取；单页失败记作 { url, error }，不影响整体结果

• 智能选页：pages 按域名多样性选取（先每个域名取排名最高的一条，再按排名补足），避免单站垄断——某个站反爬 403 时其他域名的页面不受影响；rank 字段标注该结果在搜索结果中的原始排名

• extractMode（默认 summary）：summary 返回去噪后的正文要点（省 token），full 返回整页 Markdown

• 总结由宿主模型完成——MCP 内部不依赖任何 LLM，保持零外部依赖、厂商无关

fetch_page — 抓取网页转结构化内容

{
  "url": "https://example.com/article",
  "extractMode": "summary",
  "maxLength": 8000
}

• extractMode：summary（默认省 token，返回去噪正文 mainText）/ full（返回整页 markdown）

• 返回 { url, title, description, headings, mainText, markdown, length, truncated, cached }——headings 是页面标题大纲，Agent 可先看结构再决定是否深读

也可以用结果 id：{ "id": "a1b2c3d4", "maxLength": 8000 }。

配置（环境变量）

引擎对比

网络注意事项

• 中国大陆免代理：默认 SEARCH_ENGINE=auto + SEARCH_REGION=cn-zh → bing → so360 → baidu → sogou，全部直连可用，无需任何配置。其中 360 搜索（so360）对数据中心/机房 IP 的容忍度最高，是最可靠的国内原生中文引擎。

• 海外部署：不设 SEARCH_REGION（或设为非 cn 前缀）→ 默认链 google → bing → duckduckgo → yandex，Google 质量最优、Bing 最稳，任一失败自动转移。Google/Yandex 在墙内不可达/被验证码拦截属预期（当前网络会先超时/报 RATE_LIMITED 后自动切换）。

• 免费引擎会限流。429 会以结构化错误返回（RATE_LIMITED，带 suggestedEngine 和 retryAfter）；引擎链会在 429/超时时自动故障转移。

• 部分站点（如百度百科、很多国内门户）会拒绝脚本抓取（HTTP 403）：fetch_page 返回结构化错误，research 将对应页标记为失败并继续。

• 需要访问 DuckDuckGo / Brave / Tavily 但处于墙内？用代理：

  SEARCH_ENGINE=duckduckgo SEARCH_HTTP_PROXY=http://127.0.0.1:7890 ai-search-mcp

• 礼貌爬虫定位：工具内置按引擎限频（默认 8 次/分）与随机请求间隔；百度/搜狗通过首页播种会话 Cookie（BAIDUID / SUID）提升成功率，但不做验证码绕过、UA 伪造轮换、代理池轮换等反反爬对抗——这是合规红线。被 403/验证码拦截时请降频或切换引擎。

• 百度/搜狗可用性说明（实测）：这两个引擎对网络环境很敏感——数据中心/海外 IP 下，百度即使带播种 Cookie 也会被强制图形验证码（wappass），搜狗缺少 JS 生成的 SNUID 会被 302 拦回（antispider）。因此默认环境下它们会自动故障转移到 Bing/360；若你在大陆住宅 IP 且百度/搜狗可达的环境中运行，可设 SEARCH_LANG_ROUTING=1 让中文查询优先走百度/搜狗/360（原生中文引擎，分词更好）。

• 我们遵循目标站点的 robots.txt 与服务条款；本工具只返回搜索摘要与链接，不转载全文内容。

开发（Development）

npm test          # 126 个单元测试（Node 内置 test runner）
node scripts/smoke-test.js   # 端到端冒烟：search + freshness + research（需要网络）

日志示例（stderr，SEARCH_LOG_LEVEL=debug）

[ai-search-mcp] [info] ready (version 0.3.2, engine=auto, region=cn-zh, logLevel=debug)
[ai-search-mcp] [info] rewrite q="2026年 大模型 最新进展" -> q="大模型 最新进展" +freshness=year
[ai-search-mcp] [info] search q="大模型 最新进展" engine=bing cached=false took=972ms total=3 deduped=1
[ai-search-mcp] [info] fetch url=https://example.com/ len=130 mode=summary took=1189ms
[ai-search-mcp] [debug] engine-fail engine=baidu err=RATE_LIMITED took=1203ms
[ai-search-mcp] [warn] fetch-fail url=https://baike.baidu.com/... err=ENGINE_ERROR took=512ms

许可证（License）

MIT

免责声明：本项目为独立开源项目，与 DuckDuckGo、Bing/Microsoft、Brave、Tavily、百度、搜狗均无关联、背书或赞助关系。百度/搜狗基于公开 HTML 解析，若这些站点变更页面结构可能导致解析失效。