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

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

Klicken Sie in Dive Desktop auf „+ MCP-Server hinzufügen“
Kopieren Sie diese Konfiguration und fügen Sie sie ein:

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

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.

SearXNG MCP Server

Integrations