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…
This server cannot be deployed
Maintenance
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.180 npmMIT
- 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.2554 npmMIT
- FlicenseNot gradedqualityCmaintenanceEnables web search through one or two SearxNG instances and retrieval of web pages, GitHub READMEs, and article text via MCP tools.-