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 : cadré, audité, pour des tests autorisés.
Pour des tests de sécurité autorisés uniquement. N'utilisez le serveur MCP Sn1per que contre des systèmes que vous possédez ou que vous êtes explicitement autorisé, par écrit, à tester, et dans le cadre 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 serveur MCP Sn1per 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 à côté 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 à côté 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 des données et confidentialité pour savoir ce qui quitte l'hôte.
Sn1per effectue le scan. Le serveur MCP Sn1per 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 serveur MCP Sn1per 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 env est la configuration de référence, donc --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.