ihor-sokoliuk/mcp-searxng

解決的問題

像 Claude 或 Cursor 這樣的 AI 助手通常缺乏對網際網路或私有搜尋引擎的即時存取權限。本專案透過將這些助手連接到 SearXNG 實例來彌補這一差距，讓它們無需依賴專有或付費的搜尋 API 即可執行網路搜尋並讀取網站內容。

工作原理

這是一個獨立的 Node.js 程序，作為 Model Context Protocol (MCP) 伺服器運作。它透過 HTTP JSON API 連接到 SearXNG 實例（或多個副本）。當 AI 助手請求搜尋或 URL 時，此伺服器會查詢 SearXNG、處理分頁、管理多個實例之間的故障轉移，甚至可以將網頁內容轉換為 Markdown 供助手閱讀。

適用對象

• AI 開發人員：正在構建需要即時網路數據的代理工作流（agentic workflows）。
• 進階使用者：希望為他們的助手提供私有、自託管或免費網路搜尋功能的 MCP 相容用戶端（如 Claude Desktop 或 Cursor）使用者。
• 注重隱私的使用者：希望使用 SearXNG 以避免將所有搜尋查詢直接發送到大型商業搜尋引擎的使用者。

亮點

• 網路搜尋與讀取：支援一般、新聞及文章查詢，並為 URL 提供感知內容類型的 Markdown 轉換。
• 高可用性：支援具有自動故障轉移或並行扇出（fan-out）以合併結果的多個 SearXNG 副本。
• 智慧快取：對搜尋結果和 URL 內容均使用記憶體快取，以減少冗餘的網路請求。
• 強健性：包括針對禁用 JSON 的實例的 HTML 回退方案、URL 讀取的 SSRF 保護以及代理支援。