
SearXNG HTTP MCP
io.github.whw23由 GitHub 帳號 whw23 發布v2026.55.0更新於 Oct 24, 2026
Self-contained SearXNG metasearch MCP server. One Docker image, 200+ engines, privacy-first.
概覽
自包含的 SearXNG 元搜尋 MCP 伺服器,讓助理透過 200 多個引擎進行注重隱私的網頁搜尋,並支援分類、自動完成與引擎探索。
- 可以做什麼
- 透過 SearXNG 在 200 多個引擎上搜尋網頁,可依分類、引擎、語言、時間範圍、安全搜尋與結果數量篩選,支援最多 5 頁平行抓取以及精簡或完整輸出格式。為不完整的查詢取得自動完成建議。查詢已啟用的引擎與分類,以便精準指定搜尋範圍。透過內建的 SearXNG 網頁介面設定引擎與語言。
- 適用情境
- 當助理需要一般網頁搜尋結果、又不想使用付費搜尋 API,並希望搜尋流量經過自架、注重隱私的元搜尋執行個體時使用。適合一次 Docker 部署服務多個用戶端,或本機 stdio 容器無需額外設定的情境。
- 執行需求
- 以本機程序方式執行:Docker 映像(ghcr.io)的 stdio 模式,或在指定連接埠上的 HTTP 服務模式;uvx 模式需要 Python 3.14+ 以及一個既有的 SearXNG 執行個體,由 SEARXNG_URL 指定。自包含模式需要 Docker。搜尋需要網路存取。API_KEY 為選用,用於啟用身分驗證。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 SearXNG HTTP MCP,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
[License] [Docker Image] [Build Status] [Python 3.14+] [Transport] [MCP Compatible] [PyPI] [MCP Registry] [OpenSSF Scorecard] [OpenSSF Best Practices] [Mentioned in Awesome MCP Servers] [Glama score]
中文 · Quick Start · Features · Architecture · Comparison · Usage · MCP Tools · Client Config · Plugin · Contributing
A self-contained MCP server that wraps SearXNG — a free, privacy-respecting metasearch engine that aggregates results from 200+ search engines.
🚀 Quick Start
Server mode — deploy once, connect from any client:
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:
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):
Set SEARXNG_URL to point to your SearXNG instance (default: http://127.0.0.1:8080).
✨ Features
Search
- 🔍 200+ search engines — Google, Bing, DuckDuckGo, Brave, and more via SearXNG
- 📂 30+ categories — news, images, videos, science, IT, and more
- 📄 Multi-page fanout — up to 5 pages per call
- 💡 Autocomplete suggestions — discover relevant search terms
- 🗂 Engine discovery — query available engines grouped by category
- 🎯 Token-efficient — results trimmed to essentials
Infrastructure
- 📦 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
🏛 Architecture
📊 Comparison with Alternatives
Why these five?
There are 20+ SearXNG MCP servers 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:
- 88plug/searxng-mcp — richest tool surface among SearXNG MCPs (7 tools: rendered fetch, research mode, parallel queries)
- ihor/mcp-searxng — most GitHub stars among SearXNG MCPs
- open-webSearch — top free multi-engine alternative outside the SearXNG ecosystem (Bing, Baidu, DuckDuckGo, Brave, etc.)
- exa-mcp-server — most popular commercial search API MCP
- Perplexity MCP — commercial AI-powered search, highest star count in the search MCP space
Why fewer tools?
MCP 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:
- 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.
- Multi-query parallel search is client-side orchestration. LLM clients can fire multiple
searchcalls in parallel — asearch_manytool only adds token overhead for tool selection with no real benefit. - 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.
Instead 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).
📖 Usage
🌐 HTTP Mode (default)
📡 stdio Mode
No ports exposed. Communication via stdin/stdout. SearXNG runs internally for the MCP tools.
🐍 uvx Mode
Requires Python 3.14+ and an existing SearXNG instance. No Docker needed.
⚙️ Environment Variables
🔐 Authentication
When API_KEY is set, all requests require one of:
x-api-keyheader — for MCP clients:x-api-key: your-key- HTTP Basic Auth — for browsers
[!TIP] Browser Login: When accessing the Web UI with
[Browser Login Dialog]API_KEYenabled, the browser will show a login dialog. Leave the username empty and enter your API key as the password.
When API_KEY is not set, all requests are open.
🔧 MCP Tools Reference
🔍 search — Search the web using SearXNG
Aggregates results from 200+ search engines with privacy.
Returns: results, answers, suggestions, corrections, infoboxes.
💡 autocomplete — Get search query suggestions
🗂 engine_info — Discover available engines and categories
No parameters. Returns the list of enabled engines grouped by category.
Returns:
Use this to discover what engines are available before calling search with specific engines or categories filters.
🔌 Client Configuration
The 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:
[!NOTE] Field-name differences: ZCode uses
mcp.servers; Kilo Code uses a top-levelmcpkey with"type": "remote"; Windsurf usesserverUrlinstead ofurl; VS Code Copilot uses a top-levelserverskey; OpenCode nests undermcpwith"type": "remote"; Codex and Hermes usemcp_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.
[Claude] Claude Desktop
Server mode — edit ~/Library/Application Support/Claude/claude_desktop_config.json:
Local mode:
uvx mode:
[Claude] Claude Code
Server mode (CLI):
Server mode (JSON) — the same mcpServers structure works in a team-shared project .mcp.json or a user-wide global ~/.claude.json:
Local mode:
uvx mode:
[Cline] Cline
Configure via Cline's MCP settings panel in VS Code (Cline > MCP Servers > Add).
Server mode:
Local mode:
uvx mode:
🟦 ZCode (Zhipu AI · GLM)
Server mode — edit ~/.zcode/cli/config.json (user-wide) or .zcode/config.json (project):
Local mode:
uvx mode:
ZCode also accepts the standard mcpServers structure (e.g. in .agents/mcp.json). Alternatively, add servers via Settings → MCP Servers → New MCP Server.
⚡ Kilo Code
Server mode — edit ~/.config/kilo/kilo.jsonc (global) or .kilo/kilo.jsonc (project):
Local mode:
uvx mode:
🥧 Pi
Install the MCP adapter once, then add a standard mcpServers block — e.g. in ~/.pi/agent/mcp.json (all projects) or .pi/mcp.json (project):
Restart Pi after installing.
Server mode:
Local mode:
uvx mode:
🧩 AI Coding Agent Plugin
Compatible with Claude Code, GitHub Copilot CLI, and OpenAI Codex CLI. Add the marketplace, then install the plugin that fits your setup:
All plugins include:
- 🔍
/web-search-via-searxngskill — search the web with category selection guide and usage rules - 🤖
web-searcheragent — research subagent with:- 🌐 Multi-language parallel search — auto-detects query language, searches in multiple languages for broader coverage
- 🛡 Source credibility tiers — Tier 1/2/3 classification with AI poisoning defense
- ✅ Cross-validation — key facts require 2+ independent sources
- 🔍 WebFetch deep reading — reads full pages from credible sources, not just snippets
- 🔄 Multi-round iterative search — up to 3 rounds with automatic deepening on gaps
- ⏱ Timeliness evaluation — flags outdated content, states source date ranges
- 📝 Footnote-style references — structured output with inline source citations
🐍 Standalone mode — uvx, no Docker, bring your own SearXNG
Runs via uvx. Requires Python 3.14+ and an existing SearXNG instance. Set SEARXNG_URL in ~/.claude/settings.json:
🐳 Local mode — Docker stdio, zero config
Runs SearXNG in a local Docker container via stdio. Requires Docker installed.
🌐 Remote mode — connect to a deployed server via HTTP
Connects to a deployed SearXNG MCP server. Requires env vars SEARXNG_MCP_URL and SEARXNG_API_KEY.
Add to ~/.claude/settings.json under the env field:
Then restart Claude Code.
🛠 SearXNG Configuration
🖥 Via Web UI
Access 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.
💾 Via Volume Mount — persistent configuration
Mount the SearXNG config directory for persistent configuration:
SearXNG generates settings.yml on first startup. The container automatically enables JSON format output required by MCP tools.
🏗 Build from Source
🤝 Contributing
See CONTRIBUTING.md for the full workflow, CI requirements, and development setup.
- 🍴 Fork the repository and enable GitHub Actions in your fork
- 🌿 Create a feature branch from
dev - ✍️ Make your changes
- ✅ Run tests:
pytest tests/ -v— CI must pass in your fork before opening a PR - 📬 Submit a PR to
dev
Development happens on the dev branch. Merges to main trigger image builds.
📄 License
MIT — MCP server code.
SearXNG itself is licensed under AGPL-3.0-or-later.
來源:README.md,提交 e75d94a
工具
0版本歷史
1- v2026.55.0最新Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分