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>/mcp an, was Remote-/Cross-Domain-Aufrufe erleichtert.

• Verwendet den zustandslosen (stateless) Streamable-HTTP-Modus; Clients müssen keine Mcp-Session-Id verwalten und können direkt parallel aufrufen.

• Unterstützt die Anpassung der SearXNG-Instanzadresse über Umgebungsvariablen, was die private Bereitstellung erleichtert.

Related MCP server: SearXNG MCP Server

Umgebungsvariablen

Lokale Ausführung

# 安装依赖（建议使用虚拟环境）
pip install -r requirements.txt

# 可选：自定义 SearXNG 实例（只需填根地址）
export SEARXNG_URL="https://your-searxng-instance"

# 启动服务
python Server.py

Nach dem Start lautet der MCP-Endpunkt:

http://localhost:9000/mcp

Docker-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-mcp

Zum Ä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-mcp

Online-Image verwenden

docker run -d \
  --name searxng-mcp \
  -p 9000:9000 \
  -e SEARXNG_URL="https://searxng.abc.com" \
  muzihuaner/searxng-mcp:latest

Zugriffsadresse

Nach der Bereitstellung hat der MCP-Endpunkt das Format:

http://<你的服务器域名或IP>:<端口>/mcp

Zum 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 False zurü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"].