A self-contained MCP server that wraps SearXNG — a free, privacy-respecting metasearch engine that aggregates results from 200+ search engines.

Server mode — deploy once, connect from any client:

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

Then connect your client to http://YOUR_HOST:YOUR_PORT/mcp/. To enable API key auth, see Authentication.

Local mode — no server needed, run directly in your client:

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

Add this as a stdio MCP server in your client — see Client Configuration for details.

uvx mode — if you already have SearXNG running (install guide):

uvx searxng-http-mcp

Set SEARXNG_URL to point to your SearXNG instance (default: http://127.0.0.1:8080).

📦 Self-contained — SearXNG built into Docker image
🔄 Triple transport — HTTP server, Docker stdio, and uvx standalone
🔐 Authentication — x-api-key + HTTP Basic Auth
🌐 Reverse proxy — SearXNG Web UI on the same port
⚡ Dynamic tool descriptions — live category lists injected at startup
📐 Rich JSON Schema — enum constraints, range limits, and descriptions on every parameter

graph LR
  Client(["client:YOUR_PORT"]) --> Expose(":8888")

searxng-http-mcp

Popularity