SearXNG MCP-Server

Eine MCP-Serverimplementierung, die sich in SearXNG integrieren lässt und datenschutzorientierte Metasuchfunktionen bietet.

Merkmale

• Metasuche : Kombiniert Ergebnisse aus mehreren Suchmaschinen

• Datenschutzorientiert : Kein Tracking, keine Benutzerprofilierung

• Mehrere Kategorien : Unterstützung für Allgemeines, Nachrichten, Wissenschaft, Dateien, Bilder, Videos und mehr

• Sprachunterstützung : Suche in bestimmten Sprachen oder allen Sprachen

• Zeitbereichsfilterung : Filtern Sie die Ergebnisse nach Tag, Woche, Monat oder Jahr

• Safe Search : Drei Ebenen der sicheren Suchfilterung

• Fallback-Unterstützung : Mehrere SearXNG-Instanzen für Zuverlässigkeit

Related MCP server: Wuxing Search MCP

Installation

Installation über Smithery

So installieren Sie den SearXNG MCP-Server für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install @kevinwatt/mcp-server-searxng --client claude

Manuelle Installation

npm install -g @kevinwatt/mcp-server-searxng

Verwendung

Direktlauf

mcp-server-searxng

Mit Dive Desktop

1. Klicken Sie in Dive Desktop auf „+ MCP-Server hinzufügen“

2. Kopieren Sie diese Konfiguration und fügen Sie sie ein:

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": [
        "-y",
        "@kevinwatt/mcp-server-searxng"
      ]
    }
  }
}

3. Klicken Sie auf „Speichern“, um den MCP-Server zu installieren

Tool-Dokumentation

• Websuche

  • Führen Sie Metasuchen über mehrere Suchmaschinen hinweg durch

  • Eingänge:

    • query (Zeichenfolge): Suchbegriffe

    • page (Nummer, optional): Seitennummer (Standard: 1)

    • language (Zeichenfolge, optional): Sprachcode (z. B. „en“, „all“, Standard: „all“)

    • categories (Array, optional): Suchkategorien (Standard: ['allgemein'])

      • Verfügbar: „Allgemein“, „Nachrichten“, „Wissenschaft“, „Dateien“, „Bilder“, „Videos“, „Musik“, „Soziale Medien“, „IT“

    • time_range (Zeichenfolge, optional): Zeitfilter (Tag/Woche/Monat/Jahr)

    • safesearch (Zahl, optional): Sichere Suchstufe (0: Keine, 1: Moderat, 2: Streng, Standard: 1)

Entwicklung

git clone https://github.com/kevinwatt/mcp-server-searxng.git
cd mcp-server-searxng
npm install
npm run build
npm start

Lizenz

Dieser MCP-Server ist unter der MIT-Lizenz lizenziert. Weitere Informationen finden Sie in der Datei LICENSE.

Voraussetzungen

Sie benötigen eine lokale SearXNG-Instanz. So richten Sie sie ein:

Führen Sie SearXNG mit Docker aus

Schnellstart

# Create config directory
mkdir -p searxng

# Create config file
tee searxng/settings.yml << EOF
use_default_settings: true

server:
  bind_address: "0.0.0.0"
  secret_key: "CHANGE_THIS_TO_SOMETHING_SECURE"  # Generate a random key
  port: 8080

search:
  safe_search: 0
  formats:
    - html
    - json

engines:
  - name: google
    engine: google
    shortcut: g

  - name: duckduckgo
    engine: duckduckgo
    shortcut: d

  - name: bing
    engine: bing
    shortcut: b

server.limiter: false
EOF

# Start container
docker run -d \
  --name searxng \
  -p 8080:8080 \
  -v "$(pwd)/searxng:/etc/searxng" \
  searxng/searxng

Testsuchfunktion

# Test JSON API with curl
curl -v 'http://localhost:8080/search?q=test&format=json'

# Or visit in browser
http://localhost:8080/search?q=test

Behälterverwaltung

# Stop container
docker stop searxng

# Remove container
docker rm searxng

# View container logs
docker logs searxng

# Enable auto-start on boot
docker update --restart always searxng

Das Flag --restart always stellt Folgendes sicher:

• Container startet automatisch, wenn Docker-Daemon startet

• Container startet automatisch neu, wenn er abstürzt

• Der Container wird automatisch neu gestartet, wenn er gestoppt wird, es sei denn, er wird explizit vom Benutzer gestoppt

Benutzerdefinierte Konfiguration

Bearbeiten Sie searxng/settings.yml wie folgt:

• Suchmaschinenliste ändern

• Sicherheitseinstellungen anpassen

• Konfigurieren der UI-Sprache

• API-Grenzwerte ändern

Ausführliche Konfigurationsoptionen finden Sie in der SearXNG-Dokumentation.

Umgebungsvariablen

• SEARXNG_INSTANCES : Komma-getrennte Liste der URLs von SearXNG-Instanzen. Standard: http://localhost:8080

• SEARXNG_USER_AGENT : Benutzerdefinierter User-Agent-Header für Anfragen. Standard: MCP-SearXNG/1.0

• NODE_TLS_REJECT_UNAUTHORIZED : Auf „0“ setzen, um die SSL-Zertifikatsüberprüfung zu umgehen (für die Entwicklung mit selbstsignierten Zertifikaten). Standard: undefiniert (SSL-Überprüfung aktiviert).

Beispielkonfiguration mit allen Optionen:

{
  "mcpServers": {
    "searxng": {
      "name": "searxng",
      "command": "npx",
      "args": [
        "-y",
        "@kevinwatt/mcp-server-searxng"
      ],
      "env": {
        "SEARXNG_INSTANCES": "http://localhost:8080,https://searx.example.com",
        "SEARXNG_USER_AGENT": "CustomBot/1.0",
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
      }
    }
  }
}

⚠️ Warnung: Das Deaktivieren der SSL-Zertifikatsüberprüfung wird in Produktionsumgebungen nicht empfohlen.