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
- 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
- Websuche
- Führen Sie Metasuchen über mehrere Suchmaschinen hinweg durch
- Eingänge:
query (Zeichenfolge): Suchbegriffepage (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:8080SEARXNG_USER_AGENT : Benutzerdefinierter User-Agent-Header für Anfragen. Standard: MCP-SearXNG/1.0NODE_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.