{ "markdown": "
\n\n\n \n \n \"SearXNG\n\n\n

\n \"License\"\n \"Docker\n \"Build\n \"Python\n \"Transport\"\n \"MCP\n \"PyPI\"\n \"MCP\n \"OpenSSF\n \"OpenSSF\n \"Mentioned\n \"Glama\n

\n\n\"searxng-http-mcp\n\n

\n 中文 ·\n Quick Start ·\n Features ·\n Architecture ·\n Comparison ·\n Usage ·\n MCP Tools ·\n Client Config ·\n Plugin ·\n Contributing\n

\n\n
\n\nA self-contained MCP server that wraps [SearXNG](https://github.com/searxng/searxng) — a free, privacy-respecting metasearch engine that aggregates results from 200+ search engines.\n\n---\n\n## 🚀 Quick Start\n\n**Server mode** — deploy once, connect from any client:\n\n```bash\ndocker run -d --name searxng-mcp --restart unless-stopped \\\n -p YOUR_PORT:8888 --memory=512m --cpus=1 \\\n ghcr.io/whw23/searxng-http-mcp:latest\n```\n\nThen [connect your client](#-client-configuration) to `http://YOUR_HOST:YOUR_PORT/mcp/`. To enable API key auth, see [Authentication](#-authentication).\n\n**Local mode** — no server needed, run directly in your client:\n\n```bash\ndocker run --rm -i --memory=512m --cpus=1 ghcr.io/whw23/searxng-http-mcp:latest --stdio\n```\n\nAdd this as a stdio MCP server in your client — see [Client Configuration](#-client-configuration) for details.\n\n**uvx mode** — if you already have SearXNG running ([install guide](https://docs.searxng.org/admin/installation.html)):\n\n```bash\nuvx searxng-http-mcp\n```\n\nSet `SEARXNG_URL` to point to your SearXNG instance (default: `http://127.0.0.1:8080`).\n\n## ✨ Features\n\n### Search\n\n- 🔍 200+ search engines — Google, Bing, DuckDuckGo, Brave, and more via SearXNG\n- 📂 30+ categories — news, images, videos, science, IT, and more\n- 📄 Multi-page fanout — up to 5 pages per call\n- 💡 Autocomplete suggestions — discover relevant search terms\n- 🗂 Engine discovery — query available engines grouped by category\n- 🎯 Token-efficient — results trimmed to essentials\n\n### Infrastructure\n\n- 📦 Self-contained — SearXNG built into Docker image\n- 🔄 Triple transport — HTTP server, Docker stdio, and uvx standalone\n- 🔐 Authentication — `x-api-key` + HTTP Basic Auth\n- 🌐 Reverse proxy — SearXNG Web UI on the same port\n- ⚡ Dynamic tool descriptions — live category lists injected at startup\n- 📐 Rich JSON Schema — enum constraints, range limits, and descriptions on every parameter\n\n## 🏛 Architecture\n\n```mermaid\ngraph LR\n Client([\"client:YOUR_PORT\"]) --> Expose(\":8888\")\n\n subgraph Container[\"🐳 Docker Container\"]\n direction LR\n Expose --> Auth{Auth}\n Auth -->|/mcp| MCP[FastMCP Server]\n Auth -->|/*| Proxy[Reverse Proxy]\n MCP --> SearXNG[SearXNG :8080]\n Proxy --> SearXNG\n end\n\n style Expose fill:none,stroke:#2496ed,stroke-dasharray:5 5,color:#2496ed\n\n style Client fill:#4a90d9,color:#fff,stroke:#3a7bc8\n style Container fill:#f0f4f8,stroke:#2496ed,stroke-width:2px,color:#2496ed\n style Auth fill:#f5a623,color:#fff,stroke:#d4900e\n style MCP fill:#50c878,color:#fff,stroke:#3da85e\n style Proxy fill:#9b59b6,color:#fff,stroke:#8344a5\n style SearXNG fill:#e74c3c,color:#fff,stroke:#c0392b\n```\n\n## 📊 Comparison with Alternatives\n\n
\nWhy these five?\n\nThere are [20+ SearXNG MCP servers](https://glama.ai/mcp/servers?query=searxng) and many more general-purpose search MCPs. Most SearXNG wrappers only expose a basic search tool, leaving SearXNG's categories, autocomplete, and engine metadata unused. We picked five alternatives that each represent a distinct category:\n\n- **88plug/searxng-mcp** — richest tool surface among SearXNG MCPs (7 tools: rendered fetch, research mode, parallel queries)\n- **ihor/mcp-searxng** — most GitHub stars among SearXNG MCPs\n- **open-webSearch** — top free multi-engine alternative outside the SearXNG ecosystem (Bing, Baidu, DuckDuckGo, Brave, etc.)\n- **exa-mcp-server** — most popular commercial search API MCP\n- **Perplexity MCP** — commercial AI-powered search, highest star count in the search MCP space\n\n
\n\n\n\n \n \n \n \n \n \n \n \n \n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n
Feature✨ This project88plug/searxng-mcpihor/mcp-searxngopen-webSearchexa-mcp-serverPerplexity MCP
Search
200+ engines via SearXNG✅✅✅❌❌❌
30+ search categories✅❌❌❌❌❌
Multi-page fanout✅❌❌❌❌❌
Autocomplete suggestions✅❌❌❌❌❌
Engine discovery tool✅❌❌❌❌❌
Dynamic tool descriptions✅❌❌❌❌❌
Infrastructure
Self-contained (built-in search)✅❌❌✅N/AN/A
Zero-install Docker deploy✅❌❌✅❌❌
HTTP + stdio transport✅✅✅✅✅✅
Authentication✅❌❌❌✅✅
Web UI reverse proxy✅❌❌❌❌❌
AI Coding Agent Plugin✅❌❌❌❌✅
General
Free & open source✅✅✅✅❌ (paid API)❌ (paid API)
Privacy (self-hosted)✅✅✅✅❌❌
LanguagePythonPythonNode.jsTypeScriptTypeScriptTypeScript
GitHub Stars\"stars\"\"stars\"\"stars\"\"stars\"\"stars\"\"stars\"
\n\n
\nWhy fewer tools?\n\nMCP is designed for composition — clients connect multiple specialized servers, each doing one thing well. Some alternatives bundle URL fetching, rendered page extraction, multi-query fan-out, or research modes into the search server. We keep the tool surface to three (search, autocomplete, engine discovery) by design:\n\n- **URL fetching is a separate concern.** MCP clients already ship dedicated tools (WebFetch, Playwright MCP, Jina Reader). Bundling fetch into a search server mixes responsibilities and duplicates the client ecosystem.\n- **Multi-query parallel search is client-side orchestration.** LLM clients can fire multiple `search` calls in parallel — a `search_many` tool only adds token overhead for tool selection with no real benefit.\n- **Research / synthesis belongs in the LLM layer.** The model is the best synthesizer. Pushing multi-step research logic into the MCP server couples application concerns to infrastructure.\n\nInstead we invest in what the alternatives above lack: **complete SearXNG API coverage** (categories, autocomplete, engine metadata — capabilities most wrappers leave on the table), **self-contained deployment, authentication, Web UI reverse proxy, and AI coding agent plugin integration (Claude Code / Copilot CLI / Codex CLI).**\n\n
\n\n## 📖 Usage\n\n### 🌐 HTTP Mode (default)\n\n```bash\n# Without authentication\ndocker run -d --name searxng-mcp --restart unless-stopped \\\n -p YOUR_PORT:8888 --memory=512m --cpus=1 \\\n ghcr.io/whw23/searxng-http-mcp:latest\n\n# With authentication\ndocker run -d --name searxng-mcp --restart unless-stopped \\\n -p YOUR_PORT:8888 --memory=512m --cpus=1 \\\n -e API_KEY=your-secret-key \\\n ghcr.io/whw23/searxng-http-mcp:latest\n```\n\n\n\n\n
🔗 MCP Endpointhttp://YOUR_HOST:YOUR_PORT/mcp/
🖥 SearXNG Web UIhttp://YOUR_HOST:YOUR_PORT/
\n\n### 📡 stdio Mode\n\n```bash\ndocker run --rm -i --memory=512m --cpus=1 \\\n ghcr.io/whw23/searxng-http-mcp:latest --stdio\n```\n\nNo ports exposed. Communication via stdin/stdout. SearXNG runs internally for the MCP tools.\n\n### 🐍 uvx Mode\n\n```bash\n# Connect to a local SearXNG instance (default: http://127.0.0.1:8080)\nuvx searxng-http-mcp\n\n# Connect to a remote SearXNG instance\nSEARXNG_URL=http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT uvx searxng-http-mcp\n```\n\nRequires Python 3.14+ and an existing SearXNG instance. No Docker needed.\n\n### ⚙️ Environment Variables\n\n\n\n \n\n\n \n \n\n
VariableDefaultDescription
API_KEY(empty, no auth)API key for authentication
SEARXNG_URLhttp://127.0.0.1:8080SearXNG instance URL (for uvx/standalone mode)
\n\n### 🔐 Authentication\n\nWhen `API_KEY` is set, all requests require one of:\n\n- **`x-api-key` header** — for MCP clients: `x-api-key: your-key`\n- **HTTP Basic Auth** — for browsers\n\n> [!TIP]\n> **Browser Login:** When accessing the Web UI with `API_KEY` enabled, the browser will show a login dialog. **Leave the username empty** and enter your API key as the **password**.\n>\n> \"Browser\n\nWhen `API_KEY` is not set, all requests are open.\n\n---\n\n## 🔧 MCP Tools Reference\n\n
\n🔍 search — Search the web using SearXNG\n\n
\n\nAggregates results from 200+ search engines with privacy.\n\n\n\n \n\n\n \n \n \n \n \n \n \n \n \n \n\n
ParameterTypeRequiredDefaultDescription
querystringyes—The search query to use
categoriesstringno\"\"Comma-separated category names (e.g., general,news,science)
enginesstringno\"\"Comma-separated engine names (e.g., google,arxiv,wikipedia)
languagestringno\"\"Search language code (e.g., en, zh, ja)
time_rangeenumnonullday, week, month, year
safesearchenumno00=off, 1=moderate, 2=strict
pagenoint ≥1no1Starting page number
pagesint 1–5no1Number of pages to fetch in parallel
max_resultsint 1–100no10Maximum number of results to return
formatenumnocompactcompact (title/url/content) or full (+ engines/score/category/date)
\n\n**Returns:** results, answers, suggestions, corrections, infoboxes.\n\n
\n\n
\n💡 autocomplete — Get search query suggestions\n\n
\n\n\n\n \n\n\n \n\n
ParameterTypeRequiredDescription
querystringyesPartial query string to get suggestions for
\n\n
\n\n
\n🗂 engine_info — Discover available engines and categories\n\n
\n\nNo parameters. Returns the list of enabled engines grouped by category.\n\n**Returns:**\n\n```json\n{\n \"categories\": [\"general\", \"images\", \"videos\", \"news\", ...],\n \"engines\": [\"google\", \"bing\", \"duckduckgo\", ...],\n \"category_engines\": {\n \"general\": [\"google\", \"bing\", \"duckduckgo\", \"brave\", ...],\n \"science\": [\"arxiv\", \"google scholar\", \"pubmed\", ...],\n ...\n }\n}\n```\n\nUse this to discover what engines are available before calling `search` with specific `engines` or `categories` filters.\n\n
\n\n---\n\n## 🔌 Client Configuration\n\nThe following is a **baseline** server-mode (remote HTTP) example using the standard `mcpServers` JSON structure. Many clients accept this structure, but field names and required `type` values differ — see the NOTE below and adjust for your client:\n\n```json\n{\n \"mcpServers\": {\n \"searxng\": {\n \"type\": \"http\",\n \"url\": \"http://YOUR_HOST:YOUR_PORT/mcp/\",\n \"headers\": {\n \"x-api-key\": \"your-secret-key\"\n }\n }\n }\n}\n```\n\n> [!NOTE]\n> Field-name differences: **ZCode** uses `mcp.servers`; **Kilo Code** uses a top-level `mcp` key with `\"type\": \"remote\"`; **Windsurf** uses `serverUrl` instead of `url`; **VS Code Copilot** uses a top-level `servers` key; **OpenCode** nests under `mcp` with `\"type\": \"remote\"`; **Codex** and **Hermes** use `mcp_servers` (TOML/YAML). For **Claude Code**, `\"type\": \"http\"` is **required** — without it the entry is read as a stdio server and skipped. For **Cline**, set `\"type\": \"streamableHttp\"` on remote HTTP servers.\n\n
\n\"Claude\" Claude Desktop\n\n**Server mode** — edit `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"searxng\": {\n \"url\": \"http://YOUR_HOST:YOUR_PORT/mcp/\",\n \"headers\": {\n \"x-api-key\": \"your-secret-key\"\n }\n }\n }\n}\n```\n\n**Local mode**:\n\n```json\n{\n \"mcpServers\": {\n \"searxng\": {\n \"command\": \"docker\",\n \"args\": [\"run\", \"--rm\", \"-i\", \"--memory=512m\", \"--cpus=1\", \"ghcr.io/whw23/searxng-http-mcp:latest\", \"--stdio\"]\n }\n }\n}\n```\n\n**uvx mode**:\n\n```json\n{\n \"mcpServers\": {\n \"searxng\": {\n \"command\": \"uvx\",\n \"args\": [\"searxng-http-mcp\"],\n \"env\": { \"SEARXNG_URL\": \"http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT\" }\n }\n }\n}\n```\n\n
\n\n
\n\"Claude\" Claude Code\n\n**Server mode (CLI)**:\n\n```bash\nclaude mcp add --transport http searxng http://YOUR_HOST:YOUR_PORT/mcp/ \\\n --header \"x-api-key: your-secret-key\"\n```\n\n**Server mode (JSON)** — the same `mcpServers` structure works in a **team-shared** project `.mcp.json` or a **user-wide** global `~/.claude.json`:\n\n```json\n{\n \"mcpServers\": {\n \"searxng\": {\n \"type\": \"http\",\n \"url\": \"http://YOUR_HOST:YOUR_PORT/mcp/\",\n \"headers\": {\n \"x-api-key\": \"your-secret-key\"\n }\n }\n }\n}\n```\n\n**Local mode**:\n\n```bash\nclaude mcp add --transport stdio searxng -- docker run --rm -i --memory=512m --cpus=1 ghcr.io/whw23/searxng-http-mcp:latest --stdio\n```\n\n**uvx mode**:\n\n```bash\nclaude mcp add --transport stdio searxng -- uvx searxng-http-mcp\n```\n\n
\n\n
\n\"Codex\" Codex\n\n**Server mode** — add to `~/.codex/config.toml`:\n\n```toml\n[mcp_servers.searxng]\nurl = \"http://YOUR_HOST:YOUR_PORT/mcp/\"\nhttp_headers = { \"x-api-key\" = \"your-secret-key\" }\n```\n\n**Local mode**:\n\n```toml\n[mcp_servers.searxng]\ncommand = \"docker\"\nargs = [\"run\", \"--rm\", \"-i\", \"--memory=512m\", \"--cpus=1\", \"ghcr.io/whw23/searxng-http-mcp:latest\", \"--stdio\"]\n```\n\n**uvx mode**:\n\n```toml\n[mcp_servers.searxng]\ncommand = \"uvx\"\nargs = [\"searxng-http-mcp\"]\n```\n\n
\n\n
\n\"Cursor\" Cursor\n\n**Server mode** — edit `.cursor/mcp.json`:\n\n```json\n{\n \"mcpServers\": {\n \"searxng\": {\n \"url\": \"http://YOUR_HOST:YOUR_PORT/mcp/\",\n \"headers\": {\n \"x-api-key\": \"your-secret-key\"\n }\n }\n }\n}\n```\n\n**Local mode**:\n\n```json\n{\n \"mcpServers\": {\n \"searxng\": {\n \"command\": \"docker\",\n \"args\": [\"run\", \"--rm\", \"-i\", \"--memory=512m\", \"--cpus=1\", \"ghcr.io/whw23/searxng-http-mcp:latest\", \"--stdio\"]\n }\n }\n}\n```\n\n**uvx mode**:\n\n```json\n{\n \"mcpServers\": {\n \"searxng\": {\n \"command\": \"uvx\",\n \"args\": [\"searxng-http-mcp\"],\n \"env\": { \"SEARXNG_URL\": \"http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT\" }\n }\n }\n}\n```\n\n
\n\n
\n\"Copilot\" VS Code Copilot\n\n**Server mode** — add to `.vscode/mcp.json`:\n\n```json\n{\n \"servers\": {\n \"searxng\": {\n \"type\": \"http\",\n \"url\": \"http://YOUR_HOST:YOUR_PORT/mcp/\",\n \"headers\": {\n \"x-api-key\": \"your-secret-key\"\n }\n }\n }\n}\n```\n\n**Local mode**:\n\n```json\n{\n \"servers\": {\n \"searxng\": {\n \"type\": \"stdio\",\n \"command\": \"docker\",\n \"args\": [\"run\", \"--rm\", \"-i\", \"--memory=512m\", \"--cpus=1\", \"ghcr.io/whw23/searxng-http-mcp:latest\", \"--stdio\"]\n }\n }\n}\n```\n\n**uvx mode**:\n\n```json\n{\n \"servers\": {\n \"searxng\": {\n \"type\": \"stdio\",\n \"command\": \"uvx\",\n \"args\": [\"searxng-http-mcp\"],\n \"env\": { \"SEARXNG_URL\": \"http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT\" }\n }\n }\n}\n```\n\n
\n\n
\n\"Windsurf\" Windsurf\n\n**Server mode** — add to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"searxng\": {\n \"serverUrl\": \"http://YOUR_HOST:YOUR_PORT/mcp/\",\n \"headers\": {\n \"x-api-key\": \"your-secret-key\"\n }\n }\n }\n}\n```\n\n**Local mode**:\n\n```json\n{\n \"mcpServers\": {\n \"searxng\": {\n \"command\": \"docker\",\n \"args\": [\"run\", \"--rm\", \"-i\", \"--memory=512m\", \"--cpus=1\", \"ghcr.io/whw23/searxng-http-mcp:latest\", \"--stdio\"]\n }\n }\n}\n```\n\n**uvx mode**:\n\n```json\n{\n \"mcpServers\": {\n \"searxng\": {\n \"command\": \"uvx\",\n \"args\": [\"searxng-http-mcp\"],\n \"env\": { \"SEARXNG_URL\": \"http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT\" }\n }\n }\n}\n```\n\n
\n\n
\n\"Cline\" Cline\n\nConfigure via Cline's MCP settings panel in VS Code (`Cline > MCP Servers > Add`).\n\n**Server mode**:\n\n```json\n{\n \"mcpServers\": {\n \"searxng\": {\n \"type\": \"streamableHttp\",\n \"url\": \"http://YOUR_HOST:YOUR_PORT/mcp/\",\n \"headers\": {\n \"x-api-key\": \"your-secret-key\"\n }\n }\n }\n}\n```\n\n**Local mode**:\n\n```json\n{\n \"mcpServers\": {\n \"searxng\": {\n \"command\": \"docker\",\n \"args\": [\"run\", \"--rm\", \"-i\", \"--memory=512m\", \"--cpus=1\", \"ghcr.io/whw23/searxng-http-mcp:latest\", \"--stdio\"]\n }\n }\n}\n```\n\n**uvx mode**:\n\n```json\n{\n \"mcpServers\": {\n \"searxng\": {\n \"command\": \"uvx\",\n \"args\": [\"searxng-http-mcp\"],\n \"env\": { \"SEARXNG_URL\": \"http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT\" }\n }\n }\n}\n```\n\n
\n\n
\n\"OpenCode\" OpenCode\n\n**Server mode** — edit `opencode.json`:\n\n```json\n{\n \"mcp\": {\n \"searxng\": {\n \"type\": \"remote\",\n \"url\": \"http://YOUR_HOST:YOUR_PORT/mcp/\",\n \"headers\": {\n \"x-api-key\": \"your-secret-key\"\n }\n }\n }\n}\n```\n\n**Local mode**:\n\n```json\n{\n \"mcp\": {\n \"searxng\": {\n \"type\": \"local\",\n \"command\": [\"docker\", \"run\", \"--rm\", \"-i\", \"--memory=512m\", \"--cpus=1\", \"ghcr.io/whw23/searxng-http-mcp:latest\", \"--stdio\"]\n }\n }\n}\n```\n\n**uvx mode**:\n\n```json\n{\n \"mcp\": {\n \"searxng\": {\n \"type\": \"local\",\n \"command\": [\"uvx\", \"searxng-http-mcp\"]\n }\n }\n}\n```\n\n
\n\n
\n\"Hermes\" Hermes Agent\n\n**Server mode** — edit `~/.hermes/config.yaml`:\n\n```yaml\nmcp_servers:\n searxng:\n url: \"http://YOUR_HOST:YOUR_PORT/mcp/\"\n headers:\n x-api-key: \"your-secret-key\"\n```\n\n**Local mode**:\n\n```yaml\nmcp_servers:\n searxng:\n command: \"docker\"\n args: [\"run\", \"--rm\", \"-i\", \"--memory=512m\", \"--cpus=1\", \"ghcr.io/whw23/searxng-http-mcp:latest\", \"--stdio\"]\n```\n\n**uvx mode**:\n\n```yaml\nmcp_servers:\n searxng:\n command: \"uvx\"\n args: [\"searxng-http-mcp\"]\n```\n\n
\n\n
\n🟦 ZCode (Zhipu AI · GLM)\n\n**Server mode** — edit `~/.zcode/cli/config.json` (user-wide) or `.zcode/config.json` (project):\n\n```json\n{\n \"mcp\": {\n \"servers\": {\n \"searxng\": {\n \"type\": \"http\",\n \"url\": \"http://YOUR_HOST:YOUR_PORT/mcp/\",\n \"headers\": {\n \"x-api-key\": \"your-secret-key\"\n }\n }\n }\n }\n}\n```\n\n**Local mode**:\n\n```json\n{\n \"mcp\": {\n \"servers\": {\n \"searxng\": {\n \"command\": \"docker\",\n \"args\": [\"run\", \"--rm\", \"-i\", \"--memory=512m\", \"--cpus=1\", \"ghcr.io/whw23/searxng-http-mcp:latest\", \"--stdio\"]\n }\n }\n }\n}\n```\n\n**uvx mode**:\n\n```json\n{\n \"mcp\": {\n \"servers\": {\n \"searxng\": {\n \"command\": \"uvx\",\n \"args\": [\"searxng-http-mcp\"],\n \"env\": { \"SEARXNG_URL\": \"http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT\" }\n }\n }\n }\n}\n```\n\nZCode also accepts the standard `mcpServers` structure (e.g. in `.agents/mcp.json`). Alternatively, add servers via `Settings → MCP Servers → New MCP Server`.\n\n
\n\n
\n⚡ Kilo Code\n\n**Server mode** — edit `~/.config/kilo/kilo.jsonc` (global) or `.kilo/kilo.jsonc` (project):\n\n```json\n{\n \"mcp\": {\n \"searxng\": {\n \"type\": \"remote\",\n \"url\": \"http://YOUR_HOST:YOUR_PORT/mcp/\",\n \"headers\": {\n \"x-api-key\": \"your-secret-key\"\n },\n \"enabled\": true\n }\n }\n}\n```\n\n**Local mode**:\n\n```json\n{\n \"mcp\": {\n \"searxng\": {\n \"type\": \"local\",\n \"command\": [\"docker\", \"run\", \"--rm\", \"-i\", \"--memory=512m\", \"--cpus=1\", \"ghcr.io/whw23/searxng-http-mcp:latest\", \"--stdio\"],\n \"enabled\": true\n }\n }\n}\n```\n\n**uvx mode**:\n\n```json\n{\n \"mcp\": {\n \"searxng\": {\n \"type\": \"local\",\n \"command\": [\"uvx\", \"searxng-http-mcp\"],\n \"environment\": { \"SEARXNG_URL\": \"http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT\" },\n \"enabled\": true\n }\n }\n}\n```\n\n
\n\n
\n🥧 Pi\n\nInstall the MCP adapter once, then add a standard `mcpServers` block — e.g. in `~/.pi/agent/mcp.json` (all projects) or `.pi/mcp.json` (project):\n\n```bash\npi install npm:pi-mcp-adapter\n```\n\nRestart Pi after installing.\n\n**Server mode**:\n\n```json\n{\n \"mcpServers\": {\n \"searxng\": {\n \"url\": \"http://YOUR_HOST:YOUR_PORT/mcp/\",\n \"headers\": {\n \"x-api-key\": \"your-secret-key\"\n }\n }\n }\n}\n```\n\n**Local mode**:\n\n```json\n{\n \"mcpServers\": {\n \"searxng\": {\n \"command\": \"docker\",\n \"args\": [\"run\", \"--rm\", \"-i\", \"--memory=512m\", \"--cpus=1\", \"ghcr.io/whw23/searxng-http-mcp:latest\", \"--stdio\"]\n }\n }\n}\n```\n\n**uvx mode**:\n\n```json\n{\n \"mcpServers\": {\n \"searxng\": {\n \"command\": \"uvx\",\n \"args\": [\"searxng-http-mcp\"],\n \"env\": { \"SEARXNG_URL\": \"http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT\" }\n }\n }\n}\n```\n\n
\n\n---\n\n## 🧩 AI Coding Agent Plugin\n\nCompatible with **Claude Code**, **GitHub Copilot CLI**, and **OpenAI Codex CLI**. Add the marketplace, then install the plugin that fits your setup:\n\n```bash\n/plugin marketplace add whw23/searxng_http_mcp\n```\n\nAll plugins include:\n\n- 🔍 **`/web-search-via-searxng` skill** — search the web with category selection guide and usage rules\n- 🤖 **`web-searcher` agent** — research subagent with:\n - 🌐 Multi-language parallel search — auto-detects query language, searches in multiple languages for broader coverage\n - 🛡 Source credibility tiers — Tier 1/2/3 classification with AI poisoning defense\n - ✅ Cross-validation — key facts require 2+ independent sources\n - 🔍 WebFetch deep reading — reads full pages from credible sources, not just snippets\n - 🔄 Multi-round iterative search — up to 3 rounds with automatic deepening on gaps\n - ⏱ Timeliness evaluation — flags outdated content, states source date ranges\n - 📝 Footnote-style references — structured output with inline source citations\n\n
\n🐍 Standalone mode — uvx, no Docker, bring your own SearXNG\n\n
\n\n```bash\n/plugin install searxng-http-mcp-standalone@searxng-http-mcp\n```\n\nRuns via `uvx`. Requires Python 3.14+ and an existing SearXNG instance. Set `SEARXNG_URL` in `~/.claude/settings.json`:\n\n```json\n{\n \"env\": {\n \"SEARXNG_URL\": \"http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT\"\n }\n}\n```\n\n
\n\n
\n🐳 Local mode — Docker stdio, zero config\n\n
\n\n```bash\n/plugin install searxng-http-mcp@searxng-http-mcp\n```\n\nRuns SearXNG in a local Docker container via stdio. Requires Docker installed.\n\n
\n\n
\n🌐 Remote mode — connect to a deployed server via HTTP\n\n
\n\n```bash\n/plugin install searxng-http-mcp-remote@searxng-http-mcp\n```\n\nConnects to a deployed SearXNG MCP server. Requires env vars `SEARXNG_MCP_URL` and `SEARXNG_API_KEY`.\n\nAdd to `~/.claude/settings.json` under the `env` field:\n\n```json\n{\n \"env\": {\n \"SEARXNG_MCP_URL\": \"http://YOUR_HOST:YOUR_PORT/mcp/\",\n \"SEARXNG_API_KEY\": \"your-api-key\"\n }\n}\n```\n\nThen restart Claude Code.\n\n
\n\n---\n\n## 🛠 SearXNG Configuration\n\n
\n🖥 Via Web UI\n\n
\n\nAccess the SearXNG Web UI at `http://YOUR_HOST:YOUR_PORT/` to configure search engines, languages, and other settings. Changes persist during the container's lifetime.\n\n
\n\n
\n💾 Via Volume Mount — persistent configuration\n\n
\n\nMount the SearXNG config directory for persistent configuration:\n\n```bash\ndocker run -d --name searxng-mcp --restart unless-stopped \\\n -p YOUR_PORT:8888 --memory=512m --cpus=1 \\\n -v /path/to/searxng-config:/etc/searxng \\\n ghcr.io/whw23/searxng-http-mcp:latest\n```\n\nSearXNG generates `settings.yml` on first startup. The container automatically enables JSON format output required by MCP tools.\n\n
\n\n---\n\n## 🏗 Build from Source\n\n```bash\ngit clone https://github.com/whw23/searxng_http_mcp.git\ncd searxng_http_mcp\ndocker build -t searxng-http-mcp:local .\ndocker run -d --name searxng-mcp --restart unless-stopped \\\n -p YOUR_PORT:8888 --memory=512m --cpus=1 \\\n searxng-http-mcp:local\n```\n\n## 🤝 Contributing\n\nSee **[CONTRIBUTING.md](CONTRIBUTING.md)** for the full workflow, CI requirements, and development setup.\n\n1. 🍴 Fork the repository and enable GitHub Actions in your fork\n2. 🌿 Create a feature branch from `dev`\n3. ✍️ Make your changes\n4. ✅ Run tests: `pytest tests/ -v` — CI must pass in your fork before opening a PR\n5. 📬 Submit a PR to `dev`\n\nDevelopment happens on the `dev` branch. Merges to `main` trigger image builds.\n\n## 📄 License\n\n[MIT](LICENSE) — MCP server code.\n\n[SearXNG](https://github.com/searxng/searxng) itself is licensed under [AGPL-3.0-or-later](https://github.com/searxng/searxng/blob/master/LICENSE).\n", "bytes": 32559, "sha": "66ac40e3bd1c6d0530623b312800d160985089c1b455e75a8b8ad782480c556c", "repo_slug": "whw23/searxng_http_mcp", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_whw23_searxng_http_mcp_d2bd3882/readme" }