SearXNG-MCP
SearXNG MCP Server
Ein SearXNG-Such-MCP-Dienst, der auf FastMCP basiert, das Streamable HTTP-Transportprotokoll verwendet und sowohl lokal als auch per Docker bereitgestellt werden kann.
SearXNG-bezogene Links:
Offizielle Dokumentation: https://docs.searxng.org/
Online-Beispiel: https://searx.space/
Funktionen
Stellt das MCP-Tool
search(query)bereit: Ruft eine SearXNG-Instanz anhand des Schlüsselworts auf und gibt eine Zusammenfassung der Suchergebnisse zurück.Bietet den MCP-Dienst über den HTTP-Endpunkt
http://<host>:<port>/mcpan, was Remote-/Cross-Domain-Aufrufe erleichtert.Verwendet den zustandslosen (stateless) Streamable-HTTP-Modus; Clients müssen keine
Mcp-Session-Idverwalten und können direkt parallel aufrufen.Unterstützt die Anpassung der SearXNG-Instanzadresse über Umgebungsvariablen, was die private Bereitstellung erleichtert.
Related MCP server: web-search-mcp
Umgebungsvariablen
Variable | Standardwert | Beschreibung |
|
| Basisadresse der SearXNG-Instanz (JSON muss aktiviert sein) |
|
| Adresse, auf der der Dienst lauscht |
|
| Port, auf dem der Dienst lauscht |
Lokale Ausführung
# 安装依赖(建议使用虚拟环境)
pip install -r requirements.txt
# 可选:自定义 SearXNG 实例(只需填根地址)
export SEARXNG_URL="https://your-searxng-instance"
# 启动服务
python Server.pyNach dem Start lautet der MCP-Endpunkt:
http://localhost:9000/mcpDocker-Bereitstellung
Image erstellen
docker build -t searxng-mcp .Container ausführen
docker run -d \
--name searxng-mcp \
-p 9000:9000 \
-e SEARXNG_URL="https://searxng.abc.com" \
searxng-mcpZum Ändern des Ports können Sie sowohl den Container-Port als auch PORT überschreiben:
docker run -d \
--name searxng-mcp \
-p 8080:8080 \
-e PORT=8080 \
searxng-mcpOnline-Image verwenden
docker run -d \
--name searxng-mcp \
-p 9000:9000 \
-e SEARXNG_URL="https://searxng.abc.com" \
muzihuaner/searxng-mcp:latestZugriffsadresse
Nach der Bereitstellung hat der MCP-Endpunkt das Format:
http://<你的服务器域名或IP>:<端口>/mcpZum Beispiel: http://localhost:9000/mcp oder https://mcp.your-domain.com/mcp
Client-Konfiguration
Geben Sie in MCP-Clients, die Streamable HTTP unterstützen, einfach den oben genannten /mcp-Endpunkt als Dienstadresse an, zum Beispiel:
{
"mcpServers": {
"searxng": {
"url": "http://localhost:9000/mcp"
}
}
}Tool-Beschreibung
search(query: str) -> str
Ruft die SearXNG-Suche anhand des Schlüsselworts auf und gibt den content-Text der einzelnen Ergebnis-Einträge zurück, durch Zeilenumbrüche verbunden.
query: Das Suchschlüsselwort.Rückgabe: Der Textinhalt der Suchergebnisse; bei fehlgeschlagener Anfrage wird
Falsezurückgegeben.
Parallelität und Leistung
测试结果示例(局域网 / 上游 `so.xxx.cn`):
Gesamtanfragen : 100 Parallele Worker : 50 Erfolgreich : 100 Fehlgeschlagen : 0 Gesamtdauer (Sekunden) : 67.68 Durchsatz (QPS) : 1.48 Durchschnittliche Latenz (Sekunden) : 27.284 Minimale Latenz (Sekunden) : 7.203 Maximale Latenz (Sekunden) : 44.418
> 注意:端到端延迟主要取决于 SearXNG 上游实例的响应速度(本例平均约 27s 来自上游 `so.xxx.cn` 较慢),服务本身可稳定承载并发且零失败。若需提升吞吐,可:
> - 换用响应更快 / 自托管的 SearXNG 实例(通过 `SEARXNG_URL` 指定);Häufig gestellte Fragen
F: Der Client meldet den Fehler Missing session ID?
A: Dieser Dienst hat stateless_http=True aktiviert, eine Session ist nicht erforderlich. Falls der Fehler weiterhin auftritt, stellen Sie sicher, dass der Client auf den /mcp-Endpunkt zeigt.
F: Wie kann ich CORS in der Produktionsumgebung einschränken?
A: Bearbeiten Sie die CORSMiddleware in Server.py und ändern Sie allow_origins=["*"] in eine konkrete Quellenliste, z. B. ["https://your-domain.com"].
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Unofficial Serper MCP — wraps the Serper Google Search API (serper.dev)
Web search and clean-text fetch MCP server (Tavily-powered, SSRF-guarded).
Unofficial Tavily MCP — wraps the Tavily API (tavily.com)
Live AI-native web search with citations. One tool for every MCP client. Flat per-request pricing.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables privacy-focused web search via SearXNG for MCP clients, allowing users to perform searches with customizable parameters through natural language.MIT
- FlicenseNot gradedqualityDmaintenanceProvides a free web search tool to MCP clients by connecting to a self-hosted SearXNG metasearch instance, enabling users to search the web with customizable parameters like categories and time range.-
- AlicenseAqualityBmaintenanceEnables MCP-compatible clients to perform web searches through a self-hosted SearXNG instance, with support for configurable languages, categories, time ranges, and safe search settings.2550 npmMIT
- FlicenseNot gradedqualityCmaintenanceEnables web search through one or two SearxNG instances and retrieval of web pages, GitHub READMEs, and article text via MCP tools.-