mcp-searxng-public

mcp-searxng-public

公開 SearXNG インスタンスにクエリを送信し、HTML の内容を JSON 結果に解析する MCP サーバー

開発の背景

私が見てきた SearXNG 用の MCP サーバーは、すべて出力形式に「json」を使用しています。確かに、これは SearXNG MCP サーバーをより 速く コーディングする方法ですが、ほとんどの公開サーバーでは JSON 形式が公開されていないため、ほぼすべてのサーバーで機能しなくなります。

このサーバーは、最大 3 つの公開 SearXNG サーバー（メインとして 1 つを使用し、ほかをフォールバックとして使用）からデータを読み取り、結果を JSON に解析します。

インストール

npm install mcp-searxng-public でインストールします。

サーバーがインストールされている場合、実行設定は次のとおりです（Cursor または Cursor 互換クライアントの場合）。

{
  "SearXNGScraper": {
    "command": "npx",
    "args": ["mcp-searxng-public"],
    "capabilities": {
      "tool-calls": true
    },
    "env": {
      "SEARXNG_BASE_URL": "https://metacat.online;https://nyc1.sx.ggtyler.dev;https://ooglester.com;https://search.080609.xyz;https://search.canine.tools;https://search.catboy.house;https://search.citw.lgbt;https://search.einfachzocken.eu;https://search.federicociro.com;https://search.hbubli.cc;https://search.im-in.space;https://search.indst.eu",
      "DEFAULT_LANGUAGE": "en"
    }
  }
}

注： env 変数、特に SEARXNG_BASE_URL は、希望する SearXNG インスタンスを指定するように調整する必要がある場合があります。必要に応じて DEFAULT_LANGUAGE も設定できます。report タスクを実行すると、URL の行に指定できる、アクセス可能な良好な SearXNG インスタンスのレポートを取得できます。

使い方

このサーバーは 1 つのエンドポイント search を公開します。このエンドポイントは 4 つの引数を受け取ります。

• query - 検索クエリ
• time_range（任意）- https://docs.searxng.org/dev/search_api.html の仕様に従った期間パラメーター（day、month、year）を指定します。
• language（任意）- 検索に使用する言語コード（例：en、es、fr）。指定しない場合は、DEFAULT_LANGUAGE 環境変数の値がデフォルトで使用されます。どちらも設定されていない場合、SearXNG に言語パラメーターは送信されません。
• detailed（任意）- 「true」に設定すると、最大 3 台のサーバーにクエリを送信し、各サーバーから複数ページ（1、2、3 ページ目）の結果を取得して、マージおよび重複排除する、より詳細な検索を実行します。

返されるのはオブジェクトの配列です。

[
      {
        "url": "https://github.com/searxng/searxng",
        "summary": "You can start SearXNG using make run in the terminal or by pressing Ctrl+Shift+B"
      },
      {
        "url": "https://searx.bndkt.io/",
        "summary": "Powered by searxng - 2025.3.22+5986629c6 — a privacy-respecting, open metasearch engine Source code | Issue tracker | Engine stats | Public instances | Contact instance maintainer"
      },
      {
        "url": "https://docs.searxng.org/"
        "summary": "SearXNG is a free internet metasearch engine which aggregates results from up to 243 search services. Users are neither tracked nor profiled. Additionally, SearXNG can be used over Tor …"
      }
      {
        "url": "https://en.wikipedia.org/wiki/SearXNG",
        "summary": "SearXNG is federated, and as such is hosted by several instances, public and private. Private instances are hosted on a local network, or run on the user's desktop computer itself, and are …"
      }
]