Episkey-G/GrokSearch-rs

解決的問題

grok-search-rs 是一個輕量級的 Rust 驅動的模型上下文協定（MCP）伺服器，讓 AI 助手能夠執行即時網路搜尋並取得頁面內容。它彌補了 LLM（特別是 Grok/xAI 和 OpenAI 相容閘道）與即時網路之間的差距，提供一種結構化的方式，將搜尋與檢索工具整合至代理的工作流程中。

工作原理

該伺服器公開了一組工具（web_search、get_sources、web_fetch、web_map、doctor），MCP 客戶端可呼叫這些工具。支援兩種傳輸模式：本地 stdio（由客戶端啟動伺服器）與 遠端 HTTP（用於多裝置存取）。

它使用可插入的來源鏈來收集資訊，依特定順序（Tavily、Exa、TinyFish、Firecrawl）嘗試使用提供者，以確保可靠性。針對 GitHub、StackExchange、arXiv 和 Wikipedia 等特定網站，它使用專用提取器產生乾淨的 Markdown，而非一般性的爬取。

適用對象

MCP 相容 AI 助手（如 Claude Code）的開發者與使用者，希望賦予其代理網路搜尋能力、從技術文件與論壇中提取乾淨內容，並與 Grok 或其他 OpenAI 相容 LLM 閘道整合。

主要特色

• 雙傳輸支援：可透過 stdio 本地執行，或作為遠端多租戶 HTTP 服務運行。
• 回應預算管理：透過修剪回應與分頁緩存來源，管理 Token 限制。
• 專用提取器：針對 GitHub、StackExchange、arXiv 和 Wikipedia 提供高品質的 Markdown 解析。
• 可插入來源鏈：在多個搜尋提供者（Tavily、Exa、TinyFish、Firecrawl）之間提供有序回退機制。
• 彈性驗證：支援 API 金鑰與 xAI OAuth 模式，實現原生 Grok 存取。