SearXNG HTTP MCP

SearXNG MCP サーバーは20種類以上あり、汎用検索MCPはさらに多数存在します。ほとんどのSearXNGラッパーが公開するのは基本的な検索ツールだけで、SearXNGのカテゴリ、オートコンプリート、エンジンのメタデータは活用されていません。そこで、それぞれ異なるカテゴリを代表する5つの代替手段を選びました。

• 88plug/searxng-mcp — SearXNG MCPの中で最も豊富なツールを提供（7つのツール：レンダリング済みページの取得、リサーチモード、並列クエリ）
• ihor/mcp-searxng — SearXNG MCPの中でGitHubスター数が最多
• open-webSearch — SearXNGエコシステム外で最有力の無料マルチエンジン代替手段（Bing、Baidu、DuckDuckGo、Braveなど）
• exa-mcp-server — 最も人気のある商用検索API MCP
• Perplexity MCP — 商用のAI検索。検索MCP分野でスター数が最多

MCP は組み合わせて使うことを前提に設計されています。クライアントは、各自が得意分野に専念する複数の特化型サーバーに接続します。ほかの選択肢の中には、URL 取得、レンダリング済みページの抽出、複数クエリの並列実行、リサーチモードなどを検索サーバーにまとめているものもあります。私たちがツールを 3 つ（検索、オートコンプリート、エンジン検出）に絞っているのは、意図的な設計です。

• URL の取得は別の役割です。 MCP クライアントには、すでに専用ツール（WebFetch、Playwright MCP、Jina Reader）が組み込まれています。検索サーバーに取得機能をまとめると、役割が混在し、クライアントのエコシステムと機能が重複します。
• 複数クエリの並列検索は、クライアント側でオーケストレーションします。 LLM クライアントは複数の search 呼び出しを並列で実行できます。search_many ツールを追加しても、ツール選択のためのトークン消費が増えるだけで、実質的な利点はありません。
• リサーチや統合は LLM 層が担います。 最適な統合役はモデルです。複数ステップにわたるリサーチロジックを MCP サーバーに組み込むと、アプリケーション上の関心事がインフラストラクチャに結び付いてしまいます。

その代わり、上記のほかの選択肢に欠けている機能に注力しています。SearXNG API の完全なカバー範囲（カテゴリ、オートコンプリート、エンジンのメタデータなど、多くのラッパーが活用できていない機能）、**自己完結型のデプロイ、認証、Web UI のリバースプロキシ、AI コーディングエージェントのプラグイン統合（Claude Code / Copilot CLI / Codex CLI）**です。

プライバシーを保ちながら、200 以上の検索エンジンの結果を集約します。

返されるもの： 結果、回答、候補、修正候補、インフォボックス。

パラメーターはありません。有効なエンジンの一覧をカテゴリ別に返します。

返されるもの：

{
  "categories": ["general", "images", "videos", "news", ...],
  "engines": ["google", "bing", "duckduckgo", ...],
  "category_engines": {
    "general": ["google", "bing", "duckduckgo", "brave", ...],
    "science": ["arxiv", "google scholar", "pubmed", ...],
    ...
  }
}

特定の engines または categories フィルターを指定して search を呼び出す前に、利用可能なエンジンを確認するために使用します。

Claude Desktop

サーバーモード — ~/Library/Application Support/Claude/claude_desktop_config.json を編集します。

{
  "mcpServers": {
    "searxng": {
      "url": "http://YOUR_HOST:YOUR_PORT/mcp/",
      "headers": {
        "x-api-key": "your-secret-key"
      }
    }
  }
}

ローカルモード：

{
  "mcpServers": {
    "searxng": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "--memory=512m", "--cpus=1", "ghcr.io/whw23/searxng-http-mcp:latest", "--stdio"]
    }
  }
}

uvx モード：

{
  "mcpServers": {
    "searxng": {
      "command": "uvx",
      "args": ["searxng-http-mcp"],
      "env": { "SEARXNG_URL": "http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT" }
    }
  }
}

Claude Code

サーバーモード（CLI）：

claude mcp add --transport http searxng http://YOUR_HOST:YOUR_PORT/mcp/ \
  --header "x-api-key: your-secret-key"

サーバーモード（JSON） — 同じ mcpServers 構造を、チーム共有のプロジェクト .mcp.json またはユーザー全体に適用されるグローバル設定 ~/.claude.json で使用できます。

{
  "mcpServers": {
    "searxng": {
      "type": "http",
      "url": "http://YOUR_HOST:YOUR_PORT/mcp/",
      "headers": {
        "x-api-key": "your-secret-key"
      }
    }
  }
}

ローカルモード：

claude mcp add --transport stdio searxng -- docker run --rm -i --memory=512m --cpus=1 ghcr.io/whw23/searxng-http-mcp:latest --stdio

Codex

サーバーモード — ~/.codex/config.toml に追加します：

[mcp_servers.searxng]
url = "http://YOUR_HOST:YOUR_PORT/mcp/"
http_headers = { "x-api-key" = "your-secret-key" }

ローカルモード：

[mcp_servers.searxng]
command = "docker"
args = ["run", "--rm", "-i", "--memory=512m", "--cpus=1", "ghcr.io/whw23/searxng-http-mcp:latest", "--stdio"]

uvx モード：

[mcp_servers.searxng]
command = "uvx"
args = ["searxng-http-mcp"]

Cursor

サーバーモード — .cursor/mcp.json を編集します：

{
  "mcpServers": {
    "searxng": {
      "url": "http://YOUR_HOST:YOUR_PORT/mcp/",
      "headers": {
        "x-api-key": "your-secret-key"
      }
    }
  }
}

ローカルモード：

{
  "mcpServers": {
    "searxng": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "--memory=512m", "--cpus=1", "ghcr.io/whw23/searxng-http-mcp:latest", "--stdio"]
    }
  }
}

uvx モード：

{
  "mcpServers": {
    "searxng": {
      "command": "uvx",
      "args": ["searxng-http-mcp"],
      "env": { "SEARXNG_URL": "http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT" }
    }
  }
}

VS Code Copilot

サーバーモード — .vscode/mcp.json に追加します：

{
  "servers": {
    "searxng": {
      "type": "http",
      "url": "http://YOUR_HOST:YOUR_PORT/mcp/",
      "headers": {
        "x-api-key": "your-secret-key"
      }
    }
  }
}

ローカルモード：

{
  "servers": {
    "searxng": {
      "type": "stdio",
      "command": "docker",
      "args": ["run", "--rm", "-i", "--memory=512m", "--cpus=1", "ghcr.io/whw23/searxng-http-mcp:latest", "--stdio"]
    }
  }
}

uvx モード：

{
  "servers": {
    "searxng": {
      "type": "stdio",
      "command": "uvx",
      "args": ["searxng-http-mcp"],
      "env": { "SEARXNG_URL": "http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT" }
    }
  }
}

Windsurf

サーバーモード — ~/.codeium/windsurf/mcp_config.json に追加します：

{
  "mcpServers": {
    "searxng": {
      "serverUrl": "http://YOUR_HOST:YOUR_PORT/mcp/",
      "headers": {
        "x-api-key": "your-secret-key"
      }
    }
  }
}

ローカルモード：

{
  "mcpServers": {
    "searxng": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "--memory=512m", "--cpus=1", "ghcr.io/whw23/searxng-http-mcp:latest", "--stdio"]
    }
  }
}

uvx モード：

{
  "mcpServers": {
    "searxng": {
      "command": "uvx",
      "args": ["searxng-http-mcp"],
      "env": { "SEARXNG_URL": "http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT" }
    }
  }
}

Cline

VS Code の Cline の MCP 設定パネル（Cline > MCP Servers > Add）から設定します。

サーバーモード：

{
  "mcpServers": {
    "searxng": {
      "type": "streamableHttp",
      "url": "http://YOUR_HOST:YOUR_PORT/mcp/",
      "headers": {
        "x-api-key": "your-secret-key"
      }
    }
  }
}

ローカルモード：

{
  "mcpServers": {
    "searxng": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "--memory=512m", "--cpus=1", "ghcr.io/whw23/searxng-http-mcp:latest", "--stdio"]
    }
  }
}

uvx モード：

{
  "mcpServers": {
    "searxng": {
      "command": "uvx",
      "args": ["searxng-http-mcp"],
      "env": { "SEARXNG_URL": "http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT" }
    }
  }
}

OpenCode

サーバーモード — opencode.json を編集します：

{
  "mcp": {
    "searxng": {
      "type": "remote",
      "url": "http://YOUR_HOST:YOUR_PORT/mcp/",
      "headers": {
        "x-api-key": "your-secret-key"
      }
    }
  }
}

ローカルモード：

{
  "mcp": {
    "searxng": {
      "type": "local",
      "command": ["docker", "run", "--rm", "-i", "--memory=512m", "--cpus=1", "ghcr.io/whw23/searxng-http-mcp:latest", "--stdio"]
    }
  }
}

uvx モード：

{
  "mcp": {
    "searxng": {
      "type": "local",
      "command": ["uvx", "searxng-http-mcp"]
    }
  }
}

Hermes Agent

サーバーモード — ~/.hermes/config.yaml を編集します：

mcp_servers:
  searxng:
    url: "http://YOUR_HOST:YOUR_PORT/mcp/"
    headers:
      x-api-key: "your-secret-key"

ローカルモード：

mcp_servers:
  searxng:
    command: "docker"
    args: ["run", "--rm", "-i", "--memory=512m", "--cpus=1", "ghcr.io/whw23/searxng-http-mcp:latest", "--stdio"]

uvx モード：

mcp_servers:
  searxng:
    command: "uvx"
    args: ["searxng-http-mcp"]

サーバーモード — ~/.zcode/cli/config.json（ユーザー全体）または .zcode/config.json（プロジェクト）を編集します：

{
  "mcp": {
    "servers": {
      "searxng": {
        "type": "http",
        "url": "http://YOUR_HOST:YOUR_PORT/mcp/",
        "headers": {
          "x-api-key": "your-secret-key"
        }
      }
    }
  }
}

ローカルモード：

{
  "mcp": {
    "servers": {
      "searxng": {
        "command": "docker",
        "args": ["run", "--rm", "-i", "--memory=512m", "--cpus=1", "ghcr.io/whw23/searxng-http-mcp:latest", "--stdio"]
      }
    }
  }
}

uvx モード：

{
  "mcp": {
    "servers": {
      "searxng": {
        "command": "uvx",
        "args": ["searxng-http-mcp"],
        "env": { "SEARXNG_URL": "http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT" }
      }
    }
  }
}

ZCode は標準の mcpServers 構造も使用できます（例：.agents/mcp.json 内）。または、Settings → MCP Servers → New MCP Server からサーバーを追加できます。

サーバーモード — ~/.config/kilo/kilo.jsonc（グローバル）または .kilo/kilo.jsonc（プロジェクト）を編集します：

{
  "mcp": {
    "searxng": {
      "type": "remote",
      "url": "http://YOUR_HOST:YOUR_PORT/mcp/",
      "headers": {
        "x-api-key": "your-secret-key"
      },
      "enabled": true
    }
  }
}

ローカルモード：

{
  "mcp": {
    "searxng": {
      "type": "local",
      "command": ["docker", "run", "--rm", "-i", "--memory=512m", "--cpus=1", "ghcr.io/whw23/searxng-http-mcp:latest", "--stdio"],
      "enabled": true
    }
  }
}

uvx モード：

{
  "mcp": {
    "searxng": {
      "type": "local",
      "command": ["uvx", "searxng-http-mcp"],
      "environment": { "SEARXNG_URL": "http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT" },
      "enabled": true
    }
  }
}

MCP アダプターを一度インストールしてから、標準の mcpServers ブロックを追加します。たとえば、~/.pi/agent/mcp.json（すべてのプロジェクト）または .pi/mcp.json（プロジェクト）に追加します：

pi install npm:pi-mcp-adapter

インストール後、Pi を再起動してください。

サーバーモード：

{
  "mcpServers": {
    "searxng": {
      "url": "http://YOUR_HOST:YOUR_PORT/mcp/",
      "headers": {
        "x-api-key": "your-secret-key"
      }
    }
  }
}

ローカルモード：

{
  "mcpServers": {
    "searxng": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "--memory=512m", "--cpus=1", "ghcr.io/whw23/searxng-http-mcp:latest", "--stdio"]
    }
  }
}

uvx モード：

{
  "mcpServers": {
    "searxng": {
      "command": "uvx",
      "args": ["searxng-http-mcp"],
      "env": { "SEARXNG_URL": "http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT" }
    }
  }
}

/plugin install searxng-http-mcp-standalone@searxng-http-mcp

uvx 経由で実行します。Python 3.14 以降と、既存の SearXNG インスタンスが必要です。~/.claude/settings.json に SEARXNG_URL を設定してください。

{
  "env": {
    "SEARXNG_URL": "http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT"
  }
}

/plugin install searxng-http-mcp@searxng-http-mcp

stdio 経由でローカルの Docker コンテナ内に SearXNG を実行します。Docker がインストールされている必要があります。

/plugin install searxng-http-mcp-remote@searxng-http-mcp

デプロイ済みの SearXNG MCP サーバーに接続します。環境変数 SEARXNG_MCP_URL と SEARXNG_API_KEY が必要です。

~/.claude/settings.json の env フィールドに追加してください。

{
  "env": {
    "SEARXNG_MCP_URL": "http://YOUR_HOST:YOUR_PORT/mcp/",
    "SEARXNG_API_KEY": "your-api-key"
  }
}

その後、Claude Code を再起動してください。

http://YOUR_HOST:YOUR_PORT/ から SearXNG ウェブ UI にアクセスし、検索エンジン、言語、その他の設定を行います。変更はコンテナの稼働中は保持されます。

設定を永続化するには、SearXNG の設定ディレクトリをマウントしてください。

docker run -d --name searxng-mcp --restart unless-stopped \
  -p YOUR_PORT:8888 --memory=512m --cpus=1 \
  -v /path/to/searxng-config:/etc/searxng \
  ghcr.io/whw23/searxng-http-mcp:latest

SearXNG は初回起動時に settings.yml を生成します。コンテナは MCP ツールに必要な JSON 形式の出力を自動的に有効にします。