Servidor MCP que permite que assistentes de IA controlem uma instalação auto-hospedada do Sn1per, executando varreduras com escopo definido e auditadas e retornando descobertas, portas, subdomínios e tecnologias como dados estruturados.
Controle seu Sn1per auto-hospedado a partir do seu assistente de IA: com escopo definido, auditado, para testes autorizados.
Apenas para testes de segurança autorizados. Use o Servidor MCP do Sn1per somente contra sistemas que você possui ou tem permissão explícita, por escrito, para testar, e dentro do escopo dessa permissão.
Status: beta (0.9.x). Nomes de ferramentas, parâmetros e campos de saída seguem a promessa de compatibilidade para versões 0.x.
O Servidor MCP do Sn1per conecta o assistente de IA que você já usa à instalação do Sn1per no seu próprio host Linux. Ele é executado localmente via stdio ao lado do Sn1per, recusa solicitações de varredura para alvos fora do escopo que você configurar (veja os limites), registra cada solicitação de varredura, cancelamento, exclusão e exportação que executa em um log de auditoria local, e retorna os achados do Sn1per, portas abertas, subdomínios e tecnologias como dados estruturados com segredos ocultados por padrão. Ele suporta o Sn1per Community Edition 9.x e o motor 11.x usado pelo SE, Professional e Enterprise; a matriz de edições lista o que foi verificado. É gratuito e de código aberto sob a licença Apache-2.0, e destina-se apenas a testes de segurança autorizados.
O servidor é executado ao lado do Sn1per no seu host: os dados permanecem lá, e os resultados das ferramentas saem do host apenas através do seu cliente MCP e do serviço de modelo que ele utiliza. Leia Tratamento de dados e privacidade para saber o que sai do host.
O Sn1per faz a varredura. O Servidor MCP do Sn1per permite que o assistente de IA que você já usa o controle. Servidores MCP genéricos de execução de ferramentas expõem comandos individuais. O Servidor MCP do Sn1per controla os modos de varredura orquestrados do Sn1per e retorna seus resultados estruturados, com aplicação de escopo e um log de auditoria.
Substitua <user> pelo usuário que executa seu cliente MCP. O arquivo env é a configuração canônica, então --check vê exatamente o que o cliente executará.
Instale o pipx, depois instale o servidor como esse usuário (nunca execute pipx com sudo):
sudo apt install pipx
pipx ensurepath
# open a new shell, then:
pipx install sn1per-mcp==0.9.0
Crie o arquivo de ambiente /home/<user>/.config/sn1per-mcp/env com modo 0600:
mkdir -p /home/<user>/.config/sn1per-mcp
install -m 0600 /dev/null /home/<user>/.config/sn1per-mcp/env
Coloque esta linha nele, depois substitua o placeholder pelos alvos que você está autorizado a testar. O próprio placeholder é recusado (scope_invalid), então nada é escaneado até que você o faça.
SNIPER_MCP_SCOPE=<authorized-targets>
Verifique a configuração. A saída inclui o realpath do Sn1per CLI que a regra sudo deve nomear:
/home/<user>/.local/bin/sn1per-mcp --env-file /home/<user>/.config/sn1per-mcp/env --check
Adicione o drop-in do sudoers com esse realpath (/usr/share/sniper/sniper numa instalação padrão). Ignore este passo se o cliente for executado como root. Passos completos: docs/install.md.
sudo visudo -f /etc/sudoers.d/sn1per-mcp
<user> ALL=(root) NOPASSWD: /usr/share/sniper/sniper
Registre o servidor no Claude Code (outros clientes: docs/clients.md):
claude mcp add sn1per -s user -- /home/<user>/.local/bin/sn1per-mcp --env-file /home/<user>/.config/sn1per-mcp/env
Inicie uma nova sessão de cliente e pergunte: "Run sniper_status".
Apenas os clientes que passaram nos testes de cliente 0.9.0 (2026-10-12) estão listados. Os caminhos de configuração, as definições de aprovação e as notas por cliente estão em docs/clients.md.
| Cliente | Estado | Ferramentas de eliminação e exportação (requerem MCP elicitation) |
|---|---|---|
| Claude Code (2.1.284) | verificado | sim, em sessões interativas; claude -p sem um host SDK cancela a confirmação, pelo que nada é eliminado ou exportado |
| Codex CLI (0.125.0) | verificado apenas em codex exec | não em codex exec, que recusa a confirmação; a interface interativa do Codex ainda não foi testada |
| Clientes Web, móveis e de conector remoto | não suportados em 0.9.0 (apenas stdio) | não aplicável |
Claude Code: o comando de uma linha no início rápido (passo 5). Codex CLI: a entrada config.toml, e a definição de aprovação de que export_workspace necessita aí, estão em docs/clients.md. Outros clientes que iniciam servidores stdio locais ainda não foram testados com 0.9.0.
O Sn1per está noutra máquina, ou o seu cliente está em macOS ou Windows? Consulte docs/remote.md para a receita SSH (verificada com um cliente Linux OpenSSH; clientes Windows e macOS documentados, não verificados), WSL2 (documentado, não verificado) e as receitas Docker (documentadas, não verificadas).
O servidor deteta a edição e o motor a partir da CLI do Sn1per no host. "Verificado" significa exercitado pela execução de verificação 0.9.0 em 2026-10-12; "esperado" significa que não há bloqueador conhecido, mas não foi exercitado. Os resultados por ferramenta, os modos de scan que foram executados e as correções feitas após a execução estão em docs/editions.md, juntamente com as tabelas de modos e as notas por edição.