Kindly Web Search MCP Server

社区

为 AI 编程工具与智能体提供网页搜索与高质量内容抓取

★ 385 Stars 分类 · 开发工具非常热门

59FMRS · C

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

可靠性

9/20

安全与权限

13/20

维护活跃度

11/20

文档质量

14/20

安装易用性

12/20

查看 FMRS 评分方法 →

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 编程与智能体工作流。

工具能力

web_search

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

get_content

给定 URL，返回尽力提取的 Markdown 正文内容 page_content，并在顶层返回诊断信息（启用诊断时）。

安装接入

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 秒构建环境，必要时先在终端预热。

claude_desktop_config.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}"
      }
    }
  }
}

生成并校验客户端配置

选型与风险

适合谁

需要一次性获得完整讨论/文档上下文而非仅 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 密钥若写入客户端配置文件存在泄露风险
抓取失败或超时可能只返回部分内容或错误提示

常见排障

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

使用场景

AI 编程助手在排查复杂 bug 时获取完整的 StackOverflow 讨论与答案

让智能体在单次调用中拿到 GitHub Issue/Discussion 的正文、评论与反应

抓取 arXiv 论文正文与 Wikipedia 词条内容用于研究型任务

为使用依赖库的编码任务补充最新的 API 与包文档

通过 SearXNG 自托管实例在受限环境中执行搜索

支持客户端

Claude Code完整支持

Codex完整支持

Gemini CLI完整支持

Claude Desktop完整支持

Cursor完整支持

OpenClaw完整支持

Antigravity完整支持

GitHub Copilot (VS Code)完整支持