Skip to main content
Glama
SearXNG-MCP

SearXNG-MCP

by muzihuaner

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: web-search-mcp

Umgebungsvariablen

Variable

Standardwert

Beschreibung

SEARXNG_URL

https://searxng.abc.com

Basisadresse der SearXNG-Instanz (JSON muss aktiviert sein)

HOST

0.0.0.0

Adresse, auf der der Dienst lauscht

PORT

9000

Port, auf dem der Dienst lauscht

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"].

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables privacy-focused web search via SearXNG for MCP clients, allowing users to perform searches with customizable parameters through natural language.
      161 npm
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides 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.
      -
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      2
      550 npm
      MIT