/ 目錄 / 演練場 / kindly-web-search-mcp-server
● 社群 Shelpuk-AI-Technology-Consulting ⚡ 即開即用

kindly-web-search-mcp-server

作者 Shelpuk-AI-Technology-Consulting · Shelpuk-AI-Technology-Consulting/kindly-web-search-mcp-server

網路搜尋會回傳完整對話(整條 StackOverflow 討論串、GitHub issues 及其評論)——不只是你得再次取得的片段。

Kindly Web Search MCP 將搜尋(Serper/Tavily/SearXNG)與強大的內容擷取配對,理解 StackOverflow、GitHub Issues 和 arXiv 等平台。工具不會回傳強制二次擷取的片段,而是在一次呼叫中回傳完整對話。

為什麼要用

核心特性

即時演示

實際使用效果

kindly-web-search.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "kindly-web-search": {
      "command": "uvx",
      "args": [
        "kindly-web-search-mcp-server"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "kindly-web-search": {
      "command": "uvx",
      "args": [
        "kindly-web-search-mcp-server"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "kindly-web-search": {
      "command": "uvx",
      "args": [
        "kindly-web-search-mcp-server"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "kindly-web-search": {
      "command": "uvx",
      "args": [
        "kindly-web-search-mcp-server"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "kindly-web-search",
      "command": "uvx",
      "args": [
        "kindly-web-search-mcp-server"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "kindly-web-search": {
      "command": {
        "path": "uvx",
        "args": [
          "kindly-web-search-mcp-server"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add kindly-web-search -- uvx kindly-web-search-mcp-server

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: kindly-web-search-mcp-server

藉由閱讀整條 StackOverflow 討論串來除錯程式庫錯誤

👤 遇到隱晦錯誤的開發者 ⏱ ~10 min beginner

何時使用: 最上面的 SO 答案通常不對;下面的對話才有真正的修正。

前置條件
  • SERPER_API_KEY — serper.dev — 每月 2500 次免費查詢
步驟
  1. 搜尋確切的錯誤
    搜尋:'fatal error: 'openssl/opensslv.h' file not found' arm64 mac — 回傳前 3 個 SO URLs。✓ 已複製
    → 含有片段的 SO URLs
  2. 擷取最相關的完整討論串
    在最上面的 SO URL 執行 get_content——給我包括每條評論的整條討論串。✓ 已複製
    → Markdown 格式的完整問題+回答+評論
  3. 挑選討論串共識支持的修正
    討論串的評論實際驗證了哪個答案(包括被接受答案下面的)?給我確切的命令。✓ 已複製
    → 特定的命令序列

結果: 真正的修正,不只是被接受的答案——附上評論的證據。

注意事項
  • SO 頁面可能很大;完整內容可能是 10k+ token — 先要求執行摘要,然後深入鑽研
搭配使用: filesystem

閱讀有完整背景的長 GitHub Issue

👤 評估是否升級依賴項的工程師 ⏱ ~10 min beginner

何時使用: 該 issue 有 80 條評論,你需要從雜音中找到信號。

前置條件
  • GITHUB_TOKEN (optional but recommended) — 傳統或細粒度權杖;公開儲存庫的空權限集合也沒問題
步驟
  1. 提取結構化 issue 資料
    在 https://github.com/vercel/next.js/issues/12345 執行 get_content——回傳結構化後設資料加上本文和所有評論。✓ 已複製
    → 結構化提取,不是原始 HTML
  2. 提煉信號
    摘要:這是已修正、開放、或只有因應措施?維護團隊的誰發表了評論,他們的最後立場是什麼?✓ 已複製
    → 狀態+維護者立場

結果: 關於程式庫升級的根據充分的開始/不開始決定。

搭配使用: github

用完整文字存取來摘要 arXiv 論文

👤 研究人員、好奇的開發者 ⏱ ~10 min beginner

何時使用: 你不想要片段;你想引用第 3.2 節。

步驟
  1. 擷取論文
    get_content https://arxiv.org/abs/2410.XXXXX——完整文本。✓ 已複製
    → 論文的 Markdown
  2. 目標式摘要
    用 5 個要點摘要方法論(第 3 節),並引用結果表格中的關鍵宣稱。✓ 已複製
    → 附帶逐字引用的摘要

結果: 不用離開聊天就能理解論文。

組合

與其他 MCP 搭配,撬動十倍槓桿

kindly-web-search + github

Kindly 閱讀 issue 討論;github MCP 在你自己的儲存庫中建立追蹤 issue

透過 kindly 閱讀 open-upstream/project#432 上的討論,然後在我們團隊的儲存庫中開啟一個摘要該討論的陰影 issue。✓ 已複製
kindly-web-search + filesystem

將研究的答案存為 Markdown 筆記

研究『Postgres 與 pgbouncer 連線池的最佳實踐』,將完整 SO 討論串+兩個文件連結存到 ./notes/pgbouncer.md。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
web_search query: str, num_results?: int (default 3) 任何你本來就打算接著擷取的網路搜尋 1 search provider call + N fetches
get_content url: str 深入探討特定的 URL 1 fetch (plus provider ops for platform parsing)

成本與限制

運行它的成本

API 配額
Serper:2500/月免費。Tavily:1000/月免費。SearXNG 自架:無限制。
每次呼叫 Token 數
web_search 附帶完整內容:每次呼叫 2-6k。get_content:依頁面 1-10k。
費用
使用服務商免費額度時免費;自架 SearXNG 無成本
提示
進行反覆研究時,將 num_results 降為 2 — kindly 每個結果都回傳完整內容,所以 3 個可能很貴。

安全

權限、密鑰、影響範圍

憑證儲存: 環境變數:SERPER_API_KEY 或 TAVILY_API_KEY 或 SEARXNG_BASE_URL
資料出站: 對選定搜尋服務商的查詢+對結果 URLs 的擷取
切勿授予: 具有儲存庫寫入權限的 GitHub 權杖——內容擷取只需要公開讀取權限

故障排查

常見錯誤與修復

未設定提供者

至少設定 SERPER_API_KEY、TAVILY_API_KEY 或 SEARXNG_BASE_URL 中的一個。

驗證: env | grep -E 'SERPER|TAVILY|SEARXNG'
找不到 Chromium

安裝 Chrome、Edge、Brave 或 chromium。如果自動偵測失敗,設定 PUPPETEER_EXECUTABLE_PATH。

驗證: which google-chrome || which chromium
Python 版本錯誤

需要 Python 3.13+。透過 pyenv 或 uv 升級。

驗證: python3 --version

替代方案

kindly-web-search-mcp-server 對比其他方案

替代方案何時用它替代權衡
omnisearch你想在一個 MCP 中有許多提供者,包括 AI 搜尋較不具備平台感知;片段優先
brave-search你只想要搜尋,不想要完整內容擷取僅限片段
fetch MCP你不需要搜尋,只需要 URL 擷取無搜尋

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills