M
MCP 精选目录 CURATED DIRECTORY
已收录 911 个 MCP Server
EN
← 返回目录
K

Kindly Web Search MCP Server

社区
为 AI 编程工具与智能体提供网页搜索与高质量内容抓取
查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗
分类
开发工具 第 133 / 438
Stars
★ 399 非常热门
传输方式
stdio（本地进程） · Streamable HTTP · SSE
运行环境
Python 3.13+ · 预编译二进制 Chromium-based brows
凭据
需要 API Key / 凭据
许可证
MIT
最近提交
工具数
2
59FMRS · C

Kindly Web Search MCP Server 是一个专注内容质量的搜索 MCP 服务，通过专用 API 集成把 StackExchange、GitHub Issues/Discussions、Wikipedia、arXiv 的完整内容一次性交给模型，其余网页则由无头 Chromium 实时解析，并支持多种搜索提供方与代理。它适合希望减少多轮抓取、提升 AI 编程上下文的用户，但需要本地浏览器、至少一个搜索密钥，且其远程 HTTP 模式默认无认证无加密，部署时需自行加防护。

最强项 · 文档质量 14/20 最弱项 · 可靠性 9/20

可靠性
9/20
安全与权限
13/20
维护活跃度
11/20
文档质量
14/20
安装易用性
12/20
查看各项评分依据
可靠性 9/20
静态审查仅能看到 README 描述，未提供可验证的源码文件、测试用例或 CI 工作流证据；本次未执行任何代码，依校准规则可靠性上限为 12。README 声明的两个工具（web_search、get_content）与内容解析优先级链、Markdown 快速路径、浏览器池等行为描述较一致，默认超时 120s、并发上限 3、可诊断性变量（KINDLY_DIAGNOSTICS、pool.slot_probe 等）说明错误路径有一定可控设计，故给出接近上限但未满的分数。扣分点：缺乏可复核的测试与 CI 证据，首次 uvx 需 30–60s 构建、浏览器依赖与冷启动超时（TimeoutError）被明确列为常见故障，说明启动与关键路径并非稳定可复现；未提供 manifest 缓存，工具清单只能由 README 推断。
安全与权限 13/20
许可为 MIT，未见恶意行为、凭据窃取或隐蔽外传；README 明确要求以环境变量而非硬编码方式传入密钥，示例中只使用占位符（PASTE_...），未出现真实令牌，故不触发红线。正面证据包括：GITHUB_TOKEN 可只读且限定公开仓库、HTTP 传输默认仅允许 loopback 主机/源并显式说明 DNS 重绑定防护、反复警示远程 HTTP 无鉴权无加密不得暴露、明确说明代理不支持内嵌凭据。扣分点：get_content 会抓取任意给定 URL 并配合 Chromium 执行页面，存在被恶意页面驱动的 SSRF/内网探测面，文档只是建议而非在服务端强制限制（无 URL 白名单或出站策略）；浏览器复用（KINDLY_NODRIVER_REUSE_BROWSER）共享 cookie/localStorage/UA，跨请求数据边界不清；无任何工具级确认机制，联网抓取属默认副作用。综合为可见风险已被披露但权限收敛与数据边界不完整，给中等偏上分数。
维护活跃度 11/20
仓库活跃、未归档，385 星、4 个开放 issue，明确采用 MIT 许可并有清晰的所属组织（Shelpuk AI Technology Consulting），拥有者身份可辨识，无伪造迹象，故不是 0。扣分点：静态材料中没有任何发布版本号、tag、CHANGELOG、提交节奏或依赖更新记录，也未见 SECURITY.md 或安全响应渠道；版本治理与安全披露路径缺失，依赖（nodriver、httpx[socks]、PDF 转 Markdown 的可选 onnxruntime 附加项）随 Python 3.14 兼容性存在不确定性却未说明跟进机制。整体属于活跃但治理与版本化信息不足。
文档质量 14/20
文档质量是本次最突出的维度：README 分层覆盖了定位、工具签名与返回字段、六层内容解析优先级表（含各层 HTTP 客户端与代理支持差异）、Markdown 快速路径的两个探针与环境变量默认值、各主流客户端（Codex、Claude Code、Gemini CLI、OpenClaw、Antigravity、Cursor、Claude Desktop、VS Code Copilot）的完整配置片段、浏览器路径/代理/绕过列表、Docker 与 docker-compose 部署、以及详尽的故障排查与超时/并发调优参数，且明确披露了限制（代理不支持内嵌凭据、复用浏览器共享状态、远程 HTTP 无鉴权、首次启动慢、Python 3.14 可选额外项被禁用）。扣分点：README 属不受信证据，缺乏与源码交叉验证的手段；未提供成本/配额说明（仅提及提供商优先级）、未给出各搜索提供商的计费或速率差异；`_Failed to retrieve page content: TimeoutError_` 等错误串写作风格混杂，且没有提供返回值的真实样例以佐证 `page_content` 的质量承诺。
安装易用性 12/20
安装路径在文档层面相当清楚：先装 uvx（含三平台命令）、再装 Chromium 系浏览器、设置一个搜索提供商密钥、最后用统一的 uvx --from git+... 命令接入，并为八个主流客户端给出可直接粘贴的配置，还区分了 CLI 与文件两种方式，并提示权限提示型输入（VS Code）这一更安全的做法。扣分点：依赖链偏重——需要本地 Chromium/浏览器、Python 3.13+、可选的 GITHUB_TOKEN，且必须从 git 源安装而非固定版本包，首次启动需 30–60s 预热，多客户端需手工调整启动超时（MCP_TIMEOUT、startup_timeout_sec、timeout）；缺少一键安装/版本锁定，属于手工且略脆弱，且按校准规则无 CI/测试证据时安装易用性上限为 15，故给出中等偏上的分数。

静态评测 · 未实际运行收录于 2026-09-10

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络控制浏览器

适合谁

  • 需要一次性获得完整讨论/文档上下文而非仅 URL 的 AI 编程工具用户
  • 使用 Claude Code、Codex、Cursor、GitHub Copilot、Gemini CLI、Claude Desktop 等支持 MCP 的客户端
  • 在 Docker 中通过 Streamable HTTP 部署远程 MCP 服务的团队
  • 需要代理（HTTP/SOCKS5）出网环境的用户

不适合谁

  • 无法在运行 MCP 客户端的机器上安装 Chromium 类浏览器、且主要需要抓取任意网站正文的用户
  • 希望将远程 HTTP 端口直接暴露到公网的用户（该服务默认无认证、无加密）
  • 不愿提供任何搜索提供方 API 密钥的用户

所需权限

  • 读取环境变量中的搜索提供方 API 密钥（Serper/SerpBase/Tavily/SearXNG/Sofya/You.com 之一）
  • 可选的 GITHUB_TOKEN（可只读、仅限公共仓库）用于 GitHub Issues/Discussions 提取
  • 在本机启动无头 Chromium 浏览器进程以抓取任意网页
  • 按需通过代理环境变量（HTTP_PROXY/HTTPS_PROXY/ALL_PROXY）或 KINDLY_CHROME_PROXY 出网

风险与副作用

  • HTTP 传输默认无认证、无加密，暴露到公网可能被滥用
  • get_content 会抓取任意给定 URL，在服务器所在网络中可能被用来访问内网资源
  • 浏览器复用会跨请求共享 Cookie、本地存储、缓存与 User-Agent 状态
  • API 密钥若写入客户端配置文件存在泄露风险
  • 抓取失败或超时可能只返回部分内容或错误提示

安装接入

准备工作

运行环境：Python 3.13+ · 预编译二进制 Chromium-based brows

SERPER_API_KEY 可选密钥 推荐的首选搜索提供商（Google 结果）密钥，在 serper.dev 注册获取
SERPBASE_API_KEY 可选密钥 备选搜索提供商 SerpBase 的密钥，返回 Google 结果
TAVILY_API_KEY 可选密钥 Tavily 搜索 API 密钥，作为 Serper/SerpBase 的备选
SOFYA_API_KEY 可选密钥 Sofya 搜索提供商的 API 密钥
YDC_API_KEY 可选密钥 You.com 搜索 API 密钥，在 you.com/platform/api-keys 获取
GITHUB_TOKEN 可选密钥 GitHub 令牌（只读公开仓库即可），可大幅改善 GitHub Issues/Discussions 抽取质量并减少限流
SEARXNG_HEADERS_JSON 可选密钥 SearXNG 实例需要的自定义请求头（如认证），JSON 格式
其他可选配置项（26 个）
SEARXNG_BASE_URL 可选 自托管 SearXNG 实例的基础 URL，无需 API 密钥
KINDLY_BROWSER_EXECUTABLE_PATH 可选 Chromium 系浏览器可执行文件路径，仅在自动检测失败时设置
KINDLY_CHROME_PROXY 可选 无头 Chromium 的代理，值直接传给 --proxy-server，支持 http/https/socks5/socks4
KINDLY_CHROME_PROXY_BYPASS 可选 Chromium 代理绕过主机列表，逗号分隔
SEARXNG_USER_AGENT 可选 访问 SearXNG 时的自定义 User-Agent
HTTP_PROXY 可选
HTTPS_PROXY 可选
ALL_PROXY 可选
KINDLY_MARKDOWN_SUFFIX_HOSTS 可选
KINDLY_MARKDOWN_ACCEPT_PROBE 可选
KINDLY_TOOL_TOTAL_TIMEOUT_SECONDS 可选 每次 web_search / get_content 调用总超时预算，默认 120 秒
KINDLY_TOOL_TOTAL_TIMEOUT_MAX_SECONDS 可选 上述超时的上限，默认 600 秒
KINDLY_WEB_SEARCH_MAX_CONCURRENCY 可选 并行内容抓取上限，默认 3（范围 1..5）
KINDLY_NODRIVER_REUSE_BROWSER 可选
KINDLY_NODRIVER_BROWSER_POOL_SIZE 可选
KINDLY_NODRIVER_ACQUIRE_TIMEOUT_SECONDS 可选
KINDLY_NODRIVER_PORT_RANGE 可选
KINDLY_NODRIVER_RETRY_ATTEMPTS 可选
KINDLY_NODRIVER_DEVTOOLS_READY_TIMEOUT_SECONDS 可选
KINDLY_HTML_TOTAL_TIMEOUT_SECONDS 可选
KINDLY_DIAGNOSTICS 可选 设为 1 时向 stderr 输出 JSON 诊断日志并在工具结果中附带 diagnostics
FASTMCP_ALLOWED_HOSTS 可选 HTTP 传输允许的 Host 头列表（逗号分隔），覆盖默认 loopback
FASTMCP_ALLOWED_ORIGINS 可选
FASTMCP_HOST 可选
FASTMCP_PORT 可选
FASTMCP_TRANSPORT 可选

1) 安装 uvx（macOS/Linux 使用 curl 脚本，Windows 使用 PowerShell 脚本）。2) 安装 Chrome/Chromium/Edge/Brave 之一，用于 page_content 抓取（缺少浏览器时专用来源仍可用）。3) 设置至少一个搜索提供方密钥：SERPER_API_KEY、SERPBASE_API_KEY、TAVILY_API_KEY、SEARXNG_BASE_URL、SOFYA_API_KEY 或 YDC_API_KEY。4) 建议设置只读的 GITHUB_TOKEN 以获得更好的 GitHub Issue 提取效果。5) 在 MCP 客户端中配置运行命令：uvx --from git+https://github.com/Shelpuk-AI-Technology-Consulting/kindly-web-search-mcp-server kindly-web-search-mcp-server start-mcp-server。首次运行需 30–60 秒构建环境，必要时先在终端预热。

.mcp.json 
{
  "mcpServers": {
    "kindly-web-search": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/Shelpuk-AI-Technology-Consulting/kindly-web-search-mcp-server",
        "kindly-web-search-mcp-server",
        "start-mcp-server"
      ],
      "env": {
        "SERPER_API_KEY": "${SERPER_API_KEY}",
        "TAVILY_API_KEY": "${TAVILY_API_KEY}",
        "SEARXNG_BASE_URL": "${SEARXNG_BASE_URL}",
        "GITHUB_TOKEN": "${GITHUB_TOKEN}",
        "KINDLY_BROWSER_EXECUTABLE_PATH": "${KINDLY_BROWSER_EXECUTABLE_PATH}"
      }
    }
  }
}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json
{
  "servers": {
    "kindly-web-search": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/Shelpuk-AI-Technology-Consulting/kindly-web-search-mcp-server",
        "kindly-web-search-mcp-server",
        "start-mcp-server"
      ],
      "env": {
        "SERPER_API_KEY": "${SERPER_API_KEY}",
        "TAVILY_API_KEY": "${TAVILY_API_KEY}",
        "SEARXNG_BASE_URL": "${SEARXNG_BASE_URL}",
        "GITHUB_TOKEN": "${GITHUB_TOKEN}",
        "KINDLY_BROWSER_EXECUTABLE_PATH": "${KINDLY_BROWSER_EXECUTABLE_PATH}"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal
claude mcp add kindly-web-search -e 'SERPER_API_KEY=${SERPER_API_KEY}' -e 'TAVILY_API_KEY=${TAVILY_API_KEY}' -e 'SEARXNG_BASE_URL=${SEARXNG_BASE_URL}' -e 'GITHUB_TOKEN=${GITHUB_TOKEN}' -e 'KINDLY_BROWSER_EXECUTABLE_PATH=${KINDLY_BROWSER_EXECUTABLE_PATH}' -- uvx --from git+https://github.com/Shelpuk-AI-Technology-Consulting/kindly-web-search-mcp-server kindly-web-search-mcp-server start-mcp-server

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端的工具列表中确认出现 web_search 和 get_content 两个工具；可发起一次提示“搜索 uvx 用法并返回页面内容”，若返回包含标题、链接与 page_content 的结果即说明安装成功。

常见排障

  1. 提示找不到浏览器：安装 Chrome/Chromium/Edge 并设置 KINDLY_BROWSER_EXECUTABLE_PATH
  2. 连接浏览器失败：提高 KINDLY_NODRIVER_RETRY_ATTEMPTS、KINDLY_NODRIVER_DEVTOOLS_READY_TIMEOUT_SECONDS、KINDLY_HTML_TOTAL_TIMEOUT_SECONDS，并设置 NO_PROXY=localhost,127.0.0.1
  3. page_content 出现 TimeoutError：提高 KINDLY_TOOL_TOTAL_TIMEOUT_SECONDS 与 KINDLY_TOOL_TOTAL_TIMEOUT_MAX_SECONDS，必要时将 KINDLY_WEB_SEARCH_MAX_CONCURRENCY 设为 1
  4. HTTP 部署报 421/403：通过 FASTMCP_ALLOWED_HOSTS 与 FASTMCP_ALLOWED_ORIGINS 扩展允许列表
  5. web_search 报无提供方密钥：至少设置一个搜索提供方环境变量

试试这样问

连接成功后，可以直接对 AI 助手这样说：

  • 搜索 GCP Cloud Batch GPU 实例模板失败的 StackOverflow 帖子，并给出点赞最高的答案内容
  • 获取 GitHub Issue https://github.com/oraios/serena/issues/1 的完整讨论内容
  • 抓取 arXiv 论文 https://arxiv.org/abs/1706.03762 的正文并总结其方法
  • 用 web_search 查询 Serper API 的最新用法并返回页面 Markdown 内容

工具能力 2

web_search 只读
输入查询与返回结果数（默认 3），返回标题、链接、摘要以及尽力提取的 Markdown 正文内容 page_content，并为每条结果附带诊断信息（启用诊断时）。
get_content 只读
给定 URL，返回尽力提取的 Markdown 正文内容 page_content，并在顶层返回诊断信息（启用诊断时）。

使用场景

AI 编程助手在排查复杂 bug 时获取完整的 StackOverflow 讨论与答案
让智能体在单次调用中拿到 GitHub Issue/Discussion 的正文、评论与反应
抓取 arXiv 论文正文与 Wikipedia 词条内容用于研究型任务
为使用依赖库的编码任务补充最新的 API 与包文档
通过 SearXNG 自托管实例在受限环境中执行搜索

支持客户端

Claude Code
Codex
Gemini CLI
Claude Desktop
Cursor
OpenClaw
Antigravity
VS Code

依据项目文档列出，未经本站实测。

详细介绍

Kindly Web Search MCP Server 是 Shelpuk AI Technology Consulting 智能体套件的一部分，为 AI 编程工具（Claude Code、Codex、Cursor、GitHub Copilot、Gemini 等）和 AI 智能体（Claude Desktop、OpenClaw、Hermes 等）提供网络搜索与完整内容检索能力。它不仅返回搜索结果的标题、链接与摘要，还直接抓取并返回完整的对话内容（问题、回答、评论、反应与元数据），并针对 StackExchange、GitHub Issues、GitHub Discussions、Wikipedia、arXiv 做了专门的 API 集成，其他任意网址则通过本地无头 Chromium 浏览器实时解析。搜索支持 Serper、SerpBase、Tavily、SearXNG、Sofya、You.com 多个提供方并按优先级回退。该服务主要面向希望减少多轮抓取、在一次调用中拿到可用上下文的 AI 编程与智能体工作流。

同类可选方案

Context7 80 · B

Upstash 官方维护，为 AI 编码助手提供实时更新的第三方库文档

★ 63.3k · 工具数 2 与当前对比 →
与其他 MCP 横向对比

源版本 72a3e059bbdd 数据同步于 2026-10-19 查看 FMRS 评分方法