One Search MCP

🚀 OneSearch MCP 服務器：網絡搜索與爬取與抓取與提取

OneSearch MCP 服務器是一個集成了 Searxng、Tavily、DuckDuckGo、Bing 等搜索引擎的模型上下文協議（MCP）服務器實現。它支持網絡搜索、本地瀏覽器搜索、網頁抓取和內容提取功能，還與 Firecrawl 集成，為用戶提供了強大且全面的網絡信息獲取解決方案。

✨ 主要特性

• 多工具支持：支持多種網絡搜索和網頁抓取工具，如 SearXNG、Firecrawl、Tavily、DuckDuckGo、Bing 等。
• 本地瀏覽器搜索：支持多種搜索引擎，包括 Bing、Google、Baidu、Sogou 等。使用 puppeteer-core 抓取網頁內容，需要安裝本地瀏覽器，如 Chromium、Google Chrome、Google Chrome Canary 等，且免費使用，無需密鑰。
• 已啟用工具：one_search、one_scrape、one_map。
• 自託管服務支持：支持自託管 SearXNG、Firecrawl 等服務（請參閱 部署）。

📦 安裝指南

使用 Smithery 自動安裝

通過 Smithery 自動為 Claude Desktop 安裝 OneSearch：

npx -y @smithery/cli install @yokingma/one-search --client claude

手動安裝

# 手動安裝（可選）
npm install -g one-search-mcp

# 使用 npx
env SEARCH_API_URL=http://127.0.0.1:8080 FIRECRAWL_API_URL=http://127.0.0.1:3002 npx -y one-search-mcp

📚 詳細文檔

環境變量配置

搜索引擎相關：

• SEARCH_PROVIDER（可選）：使用的搜索提供程序，支持 searxng、duckduckgo、bing、tavily、local，默認為 local。
• SEARCH_API_URL（可選）：SearxNG API 的 URL，使用 searxng 時必填。
• SEARCH_API_KEY（可選）：搜索 API 的密鑰，具體取決於使用的搜索引擎。

示例配置：

# 使用 Searxng 並指定代理和日誌級別
SEARXNG_API_URL=https://api.searxng.org \
SEARXNG_API_KEY=your_api_key_here \
SEARCH_PROVIDER=searxng \
LOG_LEVEL=debug

在不同平臺的運行配置

在 Cursor 上運行

{
  "mcp": {
    "servers": [
      {
        "type": "file",
        "path": "./config.json"
      }
    ],
    "tools": {
      "one_search": {
        "env": {
          "SEARCH_API_URL": "http://127.0.0.1:8080",
          "FIRECRAWL_API_URL": "http://127.0.0.1:3002"
        }
      }
    }
  }
}

在 Windsurf 上運行

{
  "mcp_server": {
    "tools": {
      "one_search": {},
      "one_scrape": {},
      "one_map": {}
    }
  }
}

自託管服務

• Searxng：支持通過 API 調用進行網絡搜索。
• Firecrawl：提供強大的網頁抓取和爬蟲功能。

故障排除與問題解決

網絡連接問題

若無法訪問 Searxng 或 Firecrawl 服務，請檢查網絡配置和代理設置：

# 驗證 API 連通性
curl https://api.searxng.org

日誌與調試信息

啟用詳細日誌輸出以幫助排查問題：

# 啟用 debug 級別日誌
LOG_LEVEL=debug one-search-mcp

📄 許可證

本項目遵循 MIT 許可證，具體請參閱 LICENSE 文件。

通過以上內容，您可以詳細瞭解如何安裝、配置和使用 OneSearch MCP 服務器，並根據實際需求進行相應的調整和優化。