MCP Searxng

🚀 SearXNG + Puppeteer MCP Server

SearXNG + Puppeteer MCP Server は、強力なウェブ検索機能を備えた SearXNG API を統合し、@missionsquad/puppeteer-scraper を使用してライブウェブコンテンツを読み取り、処理する MCP サーバー の実装です。

このサーバーは 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 はエージェント型 AI プラットフォームで、任意のモデルに接続し、プライベートデータを活用し、複雑なタスクを自動化する協調エージェントを構築、管理、デプロイできます。無料アカウントにサインアップして始めましょう。

📄 ライセンス

この MCP サーバーは MIT ライセンスの下でライセンスされています。これは、MIT ライセンスの条件に従い、ソフトウェアを自由に使用、変更、配布できることを意味します。詳細については、プロジェクトリポジトリの LICENSE ファイルを参照してください。