Serveur MCP qui permet aux assistants IA de piloter une installation Sn1per auto-hébergée, en exécutant des scans ciblés et audités et en renvoyant les résultats, les ports, les sous-domaines et les technologies sous forme de données structurées.
Pilotez votre Sn1per auto-hébergé depuis votre assistant IA : périmètre délimité, journalisé, pour des tests autorisés.
Pour des tests de sécurité autorisés uniquement. N'utilisez le Sn1per MCP Server que contre des systèmes que vous possédez ou que vous êtes explicitement autorisé, par écrit, à tester, et dans le périmètre de cette autorisation.
Statut : bêta (0.9.x). Les noms d'outils, les paramètres et les champs de sortie suivent la promesse de compatibilité pour les versions 0.x.
Le Sn1per MCP Server connecte l'assistant IA que vous utilisez déjà à l'installation de Sn1per sur votre propre hôte Linux. Il s'exécute localement via stdio aux côtés de Sn1per, refuse les demandes de scan pour des cibles hors du périmètre que vous configurez (voir les limites), enregistre chaque demande de scan, d'annulation, de suppression et d'export qu'il traite dans un journal d'audit local, et renvoie les résultats de Sn1per, les ports ouverts, les sous-domaines et les technologies sous forme de données structurées avec les secrets masqués par défaut. Il prend en charge Sn1per Community Edition 9.x et le moteur 11.x utilisé par SE, Professional et Enterprise ; la matrice des éditions liste ce qui a été vérifié. Il est gratuit et open source sous licence Apache-2.0, et est destiné uniquement à des tests de sécurité autorisés.
Le serveur s'exécute aux côtés de Sn1per sur votre hôte : le butin y reste, et les résultats des outils ne quittent l'hôte que via votre client MCP et le service de modèle qu'il utilise. Consultez Traitement et confidentialité des données pour savoir ce qui quitte effectivement l'hôte.
Sn1per effectue le scan. Le Sn1per MCP Server permet à l'assistant IA que vous utilisez déjà de le piloter. Les serveurs MCP génériques d'exécution d'outils exposent des commandes individuelles. Le Sn1per MCP Server pilote les modes de scan orchestrés de Sn1per et renvoie ses résultats structurés, avec application du périmètre et journal d'audit.
Remplacez <user> par l'utilisateur qui exécute votre client MCP. Le fichier d'environnement est la configuration de référence, ainsi --check voit exactement ce que le client exécutera.
Installez pipx, puis installez le serveur en tant que cet utilisateur (n'exécutez jamais pipx avec sudo) :
sudo apt install pipx
pipx ensurepath
# open a new shell, then:
pipx install sn1per-mcp==0.9.0
Créez le fichier d'environnement /home/<user>/.config/sn1per-mcp/env avec le mode 0600 :
mkdir -p /home/<user>/.config/sn1per-mcp
install -m 0600 /dev/null /home/<user>/.config/sn1per-mcp/env
Mettez cette ligne dedans, puis remplacez le placeholder par les cibles que vous êtes autorisé à tester. Le placeholder lui-même est refusé (scope_invalid), donc rien n'est scanné tant que vous ne l'avez pas fait.
SNIPER_MCP_SCOPE=<authorized-targets>
Vérifiez la configuration. La sortie inclut le realpath du CLI Sn1per que la règle sudo doit nommer :
/home/<user>/.local/bin/sn1per-mcp --env-file /home/<user>/.config/sn1per-mcp/env --check
Ajoutez le fichier sudoers drop-in avec ce realpath (/usr/share/sniper/sniper sur une installation standard). Ignorez cette étape si le client s'exécute en tant que root. Étapes complètes : docs/install.md.
sudo visudo -f /etc/sudoers.d/sn1per-mcp
<user> ALL=(root) NOPASSWD: /usr/share/sniper/sniper
Enregistrez le serveur auprès de Claude Code (autres clients : docs/clients.md) :
claude mcp add sn1per -s user -- /home/<user>/.local/bin/sn1per-mcp --env-file /home/<user>/.config/sn1per-mcp/env
Démarrez une nouvelle session client et demandez : « Run sniper_status ».
Seuls les clients ayant réussi les tests client 0.9.0 (2026-10-12) sont listés. Les chemins de configuration, les paramètres d'approbation et les notes par client se trouvent dans docs/clients.md.
| Client | Statut | Outils de suppression et d'export (nécessitent l'élicitation MCP) |
|---|---|---|
| Claude Code (2.1.284) | vérifié | oui, dans les sessions interactives ; claude -p sans hôte SDK annule la confirmation, donc rien n'est supprimé ni exporté |
| Codex CLI (0.125.0) | vérifié dans codex exec uniquement | non dans codex exec, qui refuse la confirmation ; l'interface interactive Codex n'est pas encore testée |
| Clients Web, mobiles et à connecteur distant | non pris en charge dans 0.9.0 (stdio uniquement) | sans objet |
Claude Code : la commande en une ligne du démarrage rapide (étape 5). Codex CLI : l'entrée config.toml, et le paramètre d'approbation dont export_workspace a besoin à cet endroit, se trouvent dans docs/clients.md. Les autres clients qui démarrent des serveurs stdio locaux ne sont pas encore testés avec 0.9.0.
Sn1per est-il sur une autre machine, ou votre client est-il sur macOS ou Windows ? Consultez docs/remote.md pour la recette SSH (vérifiée avec un client OpenSSH Linux ; clients Windows et macOS documentés, non vérifiés), WSL2 (documenté, non vérifié) et les recettes Docker (documentées, non vérifiées).
Le serveur détecte l'édition et le moteur à partir de la CLI Sn1per sur l'hôte. « Vérifié » signifie exercé par l'exécution de vérification 0.9.0 du 2026-10-12 ; « attendu » signifie aucun blocage connu, mais non exercé. Les résultats par outil, les modes de scan exécutés et les correctifs apportés après l'exécution se trouvent dans docs/editions.md, avec les tableaux de modes et les notes par édition.