/ 目錄 / 演練場 / mcp-searxng
● 社群 ihor-sokoliuk ⚡ 即開即用

mcp-searxng

作者 ihor-sokoliuk · ihor-sokoliuk/mcp-searxng

為你的 AI 提供私有、自架的網路搜尋——不需要 API 金鑰、沒有速率限制的困擾,搜尋供應商也無法追蹤你的查詢記錄。

mcp-searxng 可連接任何 SearXNG 實例(自架或公開的皆可),並提供兩項工具:支援分頁、時間範圍、語言、安全搜尋的網路搜尋,以及將網址轉換為 Markdown 的內容擷取。若你已在運行 SearXNG,或希望在不按次計費的情況下進行零追蹤搜尋,這是最佳選擇。

為什麼要用

核心特性

即時演示

實際使用效果

searxng.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "_inferred": true
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "searxng",
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "searxng": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-searxng"
        ]
      }
    }
  }
}

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

claude mcp add searxng -- npx -y mcp-searxng

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

使用場景

實戰用法: mcp-searxng

對照多個來源查核某項說法的真實性

👤 寫作者、分析師 ⏱ ~10 min beginner

何時使用: 你需要透過多個獨立來源確認某件事的真偽。

步驟
  1. 搜尋
    搜尋該說法的確切文字,從不同網域回傳前 10 筆結果。✓ 已複製
    → 多樣化的結果清單
  2. 交叉閱讀
    對最具權威性的 3 個來源執行 web_url_read——引用與該說法相關的段落。✓ 已複製
    → 引用的原文摘要
  3. 給出判斷
    這項說法是獲得支持、尚有爭議,還是錯誤的?請具體引用來源。✓ 已複製
    → 附有引用來源的查核結論

結果: 一份附有引用來源的事實查核報告。

為團隊打造零 API 金鑰的研究助理

👤 不願意或無法購買搜尋 API 金鑰的團隊 ⏱ ~40 min intermediate

何時使用: 每個人都想使用 AI 搜尋,但沒有人想為每位成員個別管理 Tavily 金鑰。

步驟
  1. 在內部網路後端運行 SearXNG
    在團隊伺服器上設定 SearXNG 容器,並將 mcp-searxng 指向該實例。✓ 已複製
    → 所有團隊 AI 客戶端均透過共享實例進行搜尋
  2. 從多個客戶端進行測試
    分別從 Claude Desktop 和 Cursor 執行相同查詢——兩者都應連到同一個 SearXNG。✓ 已複製
    → 回傳一致的結果

結果: 全團隊共用單一實例進行 AI 搜尋,無需按人計費。

組合

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

searxng + filesystem

搜尋並儲存筆記

搜尋 'SBOM best practices',對前 3 筆結果執行 web_url_read,並將精煉摘要儲存至 ./notes/sbom.md。✓ 已複製

兩者並用——kindly 負責平台感知的完整內容擷取,searxng 負責私有的一般搜尋

初始搜尋使用 searxng;若結果來自 SO 或 GitHub,則改用 kindly 以獲取更豐富的內容。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
searxng_web_search query: str, pageno?: int, time_range?: day|week|month|year, language?: str, safesearch?: 0|1|2 任何網路搜尋需求 free (your SearXNG)
web_url_read url: str, start_heading?: int, end_heading?: int, start_paragraph?: int, end_paragraph?: int 乾淨擷取文章內容 free

成本與限制

運行它的成本

API 配額
無限制(取決於你的 SearXNG 實例)
每次呼叫 Token 數
搜尋:500-1500 tokens。讀取:視頁面而定,約 1-10k。
費用
免費
提示
善用 time_range 和 language 縮小查詢範圍——同時減少 token 消耗和 SearXNG 負載。

安全

權限、密鑰、影響範圍

憑證儲存: 不需要任何金鑰;只需設定 SEARXNG_URL
資料出站: 你的 SearXNG 實例(該實例再向上游搜尋引擎發出查詢)

故障排查

常見錯誤與修復

Connection refused

SearXNG 未運行或 SEARXNG_URL 設定錯誤。請先直接用 curl 測試該網址。

驗證: curl $SEARXNG_URL
Empty results for any query

SearXNG 被上游搜尋引擎封鎖或設定有誤。請直接在瀏覽器中開啟 /search 頁面確認。

驗證: Open $SEARXNG_URL/search?q=test
web_url_read returns mostly nav junk

部分網站大量依賴 JavaScript;請縮小標題或段落範圍,或改用其他擷取工具。

替代方案

mcp-searxng 對比其他方案

替代方案何時用它替代權衡
omnisearch你需要多供應商加上 AI 搜尋功能需要提供各供應商的 API 金鑰
kindly-web-search你需要具備平台感知能力的完整內容擷取若未搭配 SearXNG,仍需要 Serper 或 Tavily 金鑰
brave-search你可以接受使用單一商業供應商超過免費額度後需付費

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

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