Files

19 lines
1.3 KiB
Markdown

# 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é :
```bash
./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.