MCP Searxng

🚀 SearXNG + Puppeteer MCP 服務器

這是一個 MCP 服務器 實現，它集成了 SearXNG API，具備強大的網絡搜索能力，並使用 @missionsquad/puppeteer-scraper 來讀取和處理即時網絡內容。

該服務器是 Mission Squad 生態系統的一個組件，旨在提供可靠的、自主的網絡瀏覽和信息檢索服務。

✨ 主要特性

• 網絡搜索：執行常規查詢、查找新聞，並通過強大的過濾功能訪問文章。
• URL 內容讀取：抓取並處理任何 URL 的內容，返回簡潔的文本。
• 分頁功能：控制檢索搜索結果的頁碼。
• 時間過濾：按時間範圍（天、月、年）過濾搜索結果。
• 語言選擇：按首選語言過濾結果。
• 安全搜索：控制搜索結果的內容過濾級別。

🛠️ 工具

web_search

使用配置好的 SearXNG 實例執行網絡搜索。

輸入參數：

• query（字符串，必填）：搜索查詢內容。
• pageno（數字，可選）：要檢索的搜索結果頁碼，從 1 開始，默認為 1。
• count（數字，可選）：每頁返回的結果數量，默認為 10。
• time_range（字符串，可選）：按時間範圍過濾結果，有效選項為："day"、"month"、"year"。
• language（字符串，可選）：結果的語言代碼（例如，"en"、"fr"、"de"），默認為實例的設置。
• safesearch（字符串，可選）：安全搜索過濾級別，有效選項為："0"（無）、"1"（中等）、"2"（嚴格），默認為實例的設置。

get_url_content

讀取給定 URL 的內容，使用 Puppeteer 進行處理，並返回文本內容。

輸入參數：

• url（字符串，必填）：要獲取和處理的 URL。

📦 安裝指南

設置 SEARXNG_URL

此服務器需要一個正在運行的 SearXNG 實例。

1. 從 公共實例列表 中選擇一個 SearxNG 實例，或者自行部署。
2. 將 SEARXNG_URL 環境變量設置為該實例的 URL。
3. 如果未設置，服務器默認使用 http://localhost:8080。

使用 Docker 運行 SearXNG

你可以使用 Docker 在本地運行 SearXNG。

Docker 運行命令：

docker run --rm -d -p 8080:8080 -v ${PWD}/searxng:/etc/searxng:rw --name searxng searxng/searxng:latest

此命令將啟動一個 SearXNG 容器，並將其映射到本地機器的 8080 端口。

Docker Compose 示例： 創建一個 docker-compose.yml 文件，內容如下：

services:
  searxng:
    container_name: searxng
    image: docker.io/searxng/searxng:latest
    restart: unless-stopped
    ports:
      - 8081:8080
    volumes:
      - ./searxng:/etc/searxng:rw
    environment:
      - SEARXNG_BASE_URL=https://${SEARXNG_HOSTNAME:-localhost}/
      - UWSGI_WORKERS=${SEARXNG_UWSGI_WORKERS:-4}
      - UWSGI_THREADS=${SEARXNG_UWSGI_THREADS:-4}
    cap_drop:
      - ALL
    cap_add:
      - CHOWN
      - SETGID
      - SETUID
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "2"

運行 docker-compose up -d 啟動服務。請注意，此示例將服務映射到 8081 端口。

💻 使用示例

NPX

直接運行服務器進行開發或測試：

{
  "mcpServers": {
    "searxng-puppeteer": {
      "command": "npx",
      "args": ["-y", "@missionsquad/mcp-searxng-puppeteer"],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

NPM

全局安裝該軟件包：

npm install -g @missionsquad/mcp-searxng-puppeteer

然後在你的 MCP 客戶端中進行配置：

{
  "mcpServers": {
    "searxng-puppeteer": {
      "command": "mcp-searxng-puppeteer",
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

Docker

Docker 鏡像即將在 Docker Hub 上提供。若要在本地構建：

docker build -t missionsquad/mcp-searxng-puppeteer:latest .

然後，將其添加到你的 MCP 客戶端配置中：

{
  "mcpServers": {
    "searxng-puppeteer": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEARXNG_URL",
        "missionsquad/mcp-searxng-puppeteer:latest"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

🔍 在 Mission Squad 上試用

你可以在 Mission Squad 平臺上測試 @missionsquad/mcp-searxng-puppeteer 服務器和其他 MCP 服務器。Mission Squad 是一個自主人工智能平臺，允許你構建、管理和部署連接到任何模型、利用私有數據並自動化複雜任務的協作代理。註冊一個免費賬戶即可開始使用。

📄 許可證

此 MCP 服務器採用 MIT 許可證授權。這意味著你可以自由使用、修改和分發該軟件，但需遵守 MIT 許可證的條款和條件。有關更多詳細信息，請參閱項目倉庫中的 LICENSE 文件。