Files

1.3 KiB

searxng-mcp : Passerelle MCP pour SearXNG

Passerelle MCP standardisée exposant un outil unique, web_search, devant l'instance SearXNG locale sur le VPS et le NAS (Ticket infra-2026-10-040).

Fonctionnalités

  • Outil unique : web_search avec hygiène stricte des requêtes et résultats non fiables documentés.
  • Transport : Streamable HTTP sur /mcp/ et /health pour le monitoring.
  • Authentification : Jetons Bearer par assistant, vérifiés par registre d'empreintes sha256 (tokens/tokens.json).
  • Journal d'accès : Journalise chaque requête dans /app/logs/access.log (sans fuite de secret).
  • Limite de débit : 30 requêtes par minute par assistant (RATE_LIMIT_PER_MIN).
  • Sécurité : Conteneur non-root, mémoire limitée à 256 Mo, aucun port public exposé.

Gestion des jetons

Génération d'un jeton pour un assistant autorisé :

./mint-token.sh <identité> <fichier-sortie>

Le script génère un jeton aléatoire de 48 caractères hexadécimaux (24 octets), l'écrit dans le fichier cible en mode 600 (sans l'afficher), et inscrit atomiquement son empreinte sha256 dans tokens/tokens.json. Le serveur recharge dynamiquement les empreintes à chaud selon le mtime du fichier sans redémarrage du conteneur.