Server MCP che consente agli assistenti AI di pilotare un'installazione self-hosted di Sn1per, eseguendo scansioni con ambito definito e verificate, e restituendo risultati, porte, sottodomini e tecnologie come dati strutturati.
Guida il tuo Sn1per self-hosted dal tuo assistente AI: con ambito definito, verificato tramite audit, per test autorizzati.
Solo per test di sicurezza autorizzati. Usa il Sn1per MCP Server esclusivamente contro sistemi che possiedi o che sei esplicitamente autorizzato, per iscritto, a testare, e nell'ambito di tale autorizzazione.
Stato: beta (0.9.x). I nomi degli strumenti, i parametri e i campi di output seguono la promessa di compatibilità per le release 0.x.
Sn1per MCP Server collega l'assistente AI che già utilizzi all'installazione di Sn1per sul tuo host Linux. Viene eseguito localmente tramite stdio accanto a Sn1per, rifiuta le richieste di scansione per target al di fuori dell'ambito che configuri (vedi i limiti), registra ogni richiesta di scansione, annullamento, eliminazione ed esportazione su cui agisce in un log di audit locale, e restituisce i risultati di Sn1per, le porte aperte, i sottodomini e le tecnologie come dati strutturati con i segreti oscurati per impostazione predefinita. Supporta Sn1per Community Edition 9.x e il motore 11.x utilizzato da SE, Professional ed Enterprise; la matrice delle edizioni elenca ciò che è stato verificato. È gratuito e open source sotto licenza Apache-2.0, ed è destinato esclusivamente a test di sicurezza autorizzati.
Il server viene eseguito accanto a Sn1per sul tuo host: il bottino rimane lì, e i risultati degli strumenti lasciano l'host solo attraverso il tuo client MCP e il servizio del modello che utilizza. Leggi Gestione dei dati e privacy per sapere cosa lascia effettivamente l'host.
Sn1per esegue la scansione. Il Sn1per MCP Server consente all'assistente AI che già utilizzi di guidarlo. I server MCP generici per l'esecuzione di strumenti espongono singoli comandi. Il Sn1per MCP Server guida le modalità di scansione orchestrate di Sn1per e restituisce i suoi risultati strutturati, con applicazione dell'ambito e un log di audit.
Sostituisci <user> con l'utente che esegue il tuo client MCP. Il file env è la configurazione canonica, quindi --check vede esattamente ciò che eseguirà il client.
Installa pipx, poi installa il server come quell'utente (non eseguire mai pipx con sudo):
sudo apt install pipx
pipx ensurepath
# open a new shell, then:
pipx install sn1per-mcp==0.9.0
Creare il file env /home/<user>/.config/sn1per-mcp/env con modalità 0600:
mkdir -p /home/<user>/.config/sn1per-mcp
install -m 0600 /dev/null /home/<user>/.config/sn1per-mcp/env
Inserisci questa riga, poi sostituisci il segnaposto con i target che sei autorizzato a testare. Il segnaposto stesso viene rifiutato (scope_invalid), quindi non viene scansionato nulla finché non lo fai.
SNIPER_MCP_SCOPE=<authorized-targets>
Verificare la configurazione. L'output include il realpath della CLI di Sn1per che la regola sudo deve nominare:
/home/<user>/.local/bin/sn1per-mcp --env-file /home/<user>/.config/sn1per-mcp/env --check
Aggiungi il drop-in sudoers con quel realpath (/usr/share/sniper/sniper su un'installazione standard). Salta questo passaggio se il client viene eseguito come root. Passaggi completi: docs/install.md.
sudo visudo -f /etc/sudoers.d/sn1per-mcp
<user> ALL=(root) NOPASSWD: /usr/share/sniper/sniper
Registra il server con Claude Code (altri client: docs/clients.md):
claude mcp add sn1per -s user -- /home/<user>/.local/bin/sn1per-mcp --env-file /home/<user>/.config/sn1per-mcp/env
Avvia una nuova sessione client e chiedi: "Run sniper_status".
Sono elencati solo i client che hanno superato i test client 0.9.0 (2026-10-12). I percorsi di configurazione, le impostazioni di approvazione e le note per singolo client sono in docs/clients.md.
| Client | Stato | Strumenti di eliminazione ed esportazione (richiedono MCP elicitation) |
|---|---|---|
| Claude Code (2.1.284) | verificato | sì, nelle sessioni interattive; claude -p senza un host SDK annulla la conferma, quindi nulla viene eliminato o esportato |
| Codex CLI (0.125.0) | verificato solo in codex exec | no in codex exec, che rifiuta la conferma; l'interfaccia interattiva di Codex non è ancora testata |
| Client Web, mobile e remote-connector | non supportati in 0.9.0 (solo stdio) | non applicabile |
Claude Code: il comando su una riga nella guida rapida (passaggio 5). Codex CLI: la voce in config.toml, e l'impostazione di approvazione necessaria a export_workspace in quel contesto, sono in docs/clients.md. Altri client che avviano server stdio locali non sono ancora testati con la 0.9.0.
Sn1per è su un'altra macchina, o il tuo client è su macOS o Windows? Vedi docs/remote.md per la ricetta SSH (verificata con un client Linux OpenSSH; client Windows e macOS documentati, non verificati), WSL2 (documentato, non verificato) e le ricette Docker (documentate, non verificate).
Il server rileva l'edizione e il motore dalla CLI di Sn1per sull'host. "Verificato" significa esercitato dall'esecuzione di verifica 0.9.0 del 2026-10-12; "previsto" significa nessun blocco noto, ma non esercitato. I risultati per singolo strumento, le modalità di scansione eseguite e le correzioni apportate dopo l'esecuzione sono in docs/editions.md, insieme alle tabelle delle modalità e alle note per edizione.