SearXNG MCP Server

クイックスタート

既存の JSON 検索が有効な SearXNG インスタンスが必要です。このプロジェクトは MCP クライアントを SearXNG に接続するものであり、SearXNG をインストールするものではありません。ご自身で運用している、または信頼できるインスタンスを使ってください。必要に応じて、セルフホストまたはパブリックインスタンスのガイドから始めてください。

接続方法を選んでください。

Claude Desktop など、mcpServers JSON を使用するクライアントの場合は、次を追加してください。

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": ["-y", "mcp-searxng"],
      "env": { "SEARXNG_URL": "https://search.example.com" }
    }
  }
}

サンプル URL をお使いの SearXNG のベース URL に置き換えてください。他のクライアントでは設定形式が異なります。お使いのクライアント向けの手順を選んでください。ローカル STDIO の場合は MCP_HTTP_PORT を設定しないでください。Docker の場合は、コンテナへの環境変数の引き渡しも必要です。

クライアントを再読み込みし、MCP ツール一覧を確認してから、SearXNG のドキュメントを検索するよう依頼してください。シンプルなツール呼び出しは {"query":"SearXNG"} を指定した searxng_web_search です。ツールの検出だけでは SearXNG への接続はテストされません。呼び出しに失敗する場合は、トラブルシューティングから確認してください。

機能

• ページネーション、フィルター、直接回答、全文またはコンパクトなテキスト／JSON 出力で検索できます。
• HTML、構造化テキスト、長さを制限した PDF テキストを読み取り、見出しや選択したセクションを確認できます。
• インスタンスの機能を検出し、クエリの候補を取得できます。
• レプリカへのフェイルオーバー／ファンアウト、HTML フォールバック、キャッシュ、プロキシ、ブラウザーソルバーを任意で利用できます。
• ローカルの STDIO または Streamable HTTP を利用でき、静的ベアラートークンと任意の OAuth による保護にも対応しています。

機能と制限についてはツールガイド、 設定については設定リファレンス、リソース計画の範囲を限定した根拠となる 過去のデプロイ測定値をご覧ください。

mcp-searxng を選ぶ理由

プライバシーは SearXNG のデプロイ方法によって異なります。運用者が管理するインスタンスを使えば、サードパーティの検索サービス運用者を信頼せずに済みます。一方、パブリックインスタンスにはクエリが送信され、ログに記録される場合があります。SearXNG とこの MCP 統合だけでは、匿名性は確保されません。

仕組み

MCP client → mcp-searxng → SearXNG → search engines

クライアントは、STDIO プロセスを独自に起動するか、HTTP サービスに接続します。 SEARXNG_URL が示すのは SearXNG サービスであり、MCP エンドポイントではありません。URL の読み取りでは、選択したウェブサイトに直接アクセスします。相互に置き換え可能な SearXNG デプロイメント用に、セミコロン区切りのレプリカリストを指定できます。詳しくは レプリカの設定をご覧ください。

デフォルトでは STDIO を使用します。レガシーの Streamable HTTP セッションは、デフォルトでステートフルです。クライアントは処理が終わったら DELETE /mcp を送信してください。その後、セッション終了により後続のリクエストが HTTP 404 を受け取った場合は、再初期化してください。モダン HTTP リクエストと MCP_HTTP_STATELESS=true のレガシーモードはセッションレスです。詳しくは HTTP トランスポートの設定をご覧ください。

ツール

ツールガイドには、使用例とすべてのパラメーターの説明が記載されています。任意のリサーチワークフローでは、情報源の調査と根拠の引用方法について説明しています。

インストール

プロジェクトが管理する配布方法は、npm（npxを含む）とDockerです。Nixなどの追加のパッケージ形式は、コミュニティが別途管理できます。

NPXおよびnpmでインストールする場合は、Node.js 22以降が必要です。DockerイメージにはNode.jsランタイムが含まれています。

npm install -g mcp-searxng

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

docker pull isokoliuk/mcp-searxng:latest

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

docker build -t mcp-searxng:latest -f Dockerfile .

services:
  mcp-searxng:
    image: isokoliuk/mcp-searxng:latest
    stdin_open: true
    environment:
      - SEARXNG_URL=${SEARXNG_URL:?Set SEARXNG_URL in the environment}
      # Add optional variables as needed — see CONFIGURATION.md

{
  "mcpServers": {
    "searxng": {
      "command": "docker",
      "args": [
        "compose",
        "-f", "/absolute/path/to/docker-compose.yml",
        "run", "--rm", "-T", "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

services:
  mcp-searxng:
    ports:
      - "127.0.0.1:8080:8080"
    environment:
      - MCP_HTTP_PORT=8080
      - MCP_HTTP_HOST=0.0.0.0

HTTPトランスポート

HTTPを個別に実行してから、クライアントを接続してください。ローカルでの確認、静的ベアラー認証、OAuthの要件、デプロイの検証については、HTTPサーバーガイドを参照してください。

設定

デフォルトのローカル設定では、SEARXNG_URLが必須です。強化されたHTTPやOAuthなどのオプションモードには、追加の要件があります。環境変数、デフォルト値、キャッシュ、タイムアウト、プロキシ、TLS、制限については、設定リファレンスを参照してください。

オプションのMCP OAuth

HTTPデプロイでは、外部の認可プロバイダーを使ってOAuthを利用できます。 認証方式を参照してください。 静的ベアラー認証とSearXNG Basic Authは、それぞれ異なる接続を保護します。

トラブルシューティング

SearXNG からの 403 Forbidden

JSON 出力が無効になっているか、アクセス制御レイヤーによってリクエストが拒否された可能性があります。設定を変更する前に、直接確認する手順 に従ってください。ブラウザーでページが表示されても、JSON API が動作するとは限りません。

JSON を有効にできない場合（HTML フォールバック）

SEARXNG_HTML_FALLBACK=true を設定すると、403／404／JSON 以外の検索レスポンスを HTML として再試行できます。 解析はベストエフォートで行われ、メタデータは限られます。コンパクト出力ではフォールバックの マーカーが省略されます。自分が管理していないサービスで有効にする前に、 パブリックインスタンスに関するガイダンス をお読みください。

バグを報告する場合は、最小限の再現手順と関連するエラーを収集してください。

ドキュメント

テスト済みの上流設定、専門分野向けエンジンのルート、MCP 出力の制御を使って、 検索範囲を有用なものに設定 できます。 デプロイ手順 には、プライベートな Compose スタックとオプションのブラウザープロバイダーが含まれており、日付入りの 結果と既知の不具合も記載されています。

タスクからガイドを探す。これらのリンクからは、現在の main ブランチの ドキュメントが開きます。未リリースの動作にはその旨が表示されます。古いバージョンを調査する場合は、 該当する Git タグを参照してください。

コントリビューション

CONTRIBUTING.md を参照してください。

ライセンス

MIT — 詳細は LICENSE を参照してください。