Servidor MCP que permite a los asistentes de IA controlar una instalación autoalojada de Sn1per, ejecutando escaneos delimitados y auditados y devolviendo hallazgos, puertos, subdominios y tecnologías como datos estructurados.
Controla tu Sn1per autoalojado desde tu asistente de IA: con alcance definido, auditado, para pruebas autorizadas.
Solo para pruebas de seguridad autorizadas. Utiliza el Sn1per MCP Server únicamente contra sistemas que sean de tu propiedad o para los que tengas permiso explícito, por escrito, para realizar pruebas, y dentro del alcance de ese permiso.
Estado: beta (0.9.x). Los nombres de herramientas, parámetros y campos de salida siguen la promesa de compatibilidad para versiones 0.x.
Sn1per MCP Server conecta el asistente de IA que ya utilizas con la instalación de Sn1per en tu propio host Linux. Se ejecuta localmente sobre stdio junto a Sn1per, rechaza las solicitudes de escaneo de objetivos fuera del alcance que configures (consulta los límites), registra cada solicitud de escaneo, cancelación, eliminación y exportación que atiende en un registro de auditoría local, y devuelve los hallazgos, puertos abiertos, subdominios y tecnologías de Sn1per como datos estructurados con los secretos redactados de forma predeterminada. Es compatible con Sn1per Community Edition 9.x y con el motor 11.x que utilizan SE, Professional y Enterprise; la matriz de ediciones enumera lo que se ha verificado. Es gratuito y de código abierto bajo la licencia Apache-2.0, y está destinado únicamente a pruebas de seguridad autorizadas.
El servidor se ejecuta junto a Sn1per en tu host: el loot permanece allí, y los resultados de las herramientas solo salen del host a través de tu cliente MCP y del servicio de modelo que este utilice. Lee Manejo de datos y privacidad para saber qué sale del host.
Sn1per realiza el escaneo. El Sn1per MCP Server permite que el asistente de IA que ya utilizas lo controle. Los servidores MCP genéricos de ejecución de herramientas exponen comandos individuales. El Sn1per MCP Server controla los modos de escaneo orquestados de Sn1per y devuelve sus resultados estructurados, con aplicación del alcance y un registro de auditoría.
Sustituye <user> por el usuario que ejecuta tu cliente MCP. El archivo env es la configuración canónica, de modo que --check ve exactamente lo que ejecutará el cliente.
Instala pipx y luego instala el servidor como ese usuario (nunca ejecutes pipx con sudo):
sudo apt install pipx
pipx ensurepath
# open a new shell, then:
pipx install sn1per-mcp==0.9.0
Cree el archivo env /home/<user>/.config/sn1per-mcp/env con modo 0600:
mkdir -p /home/<user>/.config/sn1per-mcp
install -m 0600 /dev/null /home/<user>/.config/sn1per-mcp/env
Pon esta línea en él, luego reemplaza el marcador de posición con los objetivos que estás autorizado a probar. El propio marcador de posición es rechazado (scope_invalid), por lo que no se escanea nada hasta que lo hagas.
SNIPER_MCP_SCOPE=<authorized-targets>
Verifica la configuración. La salida incluye el realpath del CLI de Sn1per que la regla de sudo debe nombrar:
/home/<user>/.local/bin/sn1per-mcp --env-file /home/<user>/.config/sn1per-mcp/env --check
Añade el drop-in de sudoers con ese realpath (/usr/share/sniper/sniper en una instalación estándar). Omite este paso si el cliente se ejecuta como root. Pasos completos: docs/install.md.
sudo visudo -f /etc/sudoers.d/sn1per-mcp
<user> ALL=(root) NOPASSWD: /usr/share/sniper/sniper
Registre el servidor con Claude Code (otros 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 una nueva sesión de cliente y pregunte: "Run sniper_status".
Solo se enumeran los clientes que superaron las pruebas de cliente de la versión 0.9.0 (2026-10-12). Las rutas de configuración, los ajustes de aprobación y las notas por cliente están en docs/clients.md.
| Cliente | Estado | Herramientas de eliminación y exportación (requieren MCP elicitation) |
|---|---|---|
| Claude Code (2.1.284) | verificado | sí, en sesiones interactivas; claude -p sin un host SDK cancela la confirmación, por lo que no se elimina ni se exporta nada |
| Codex CLI (0.125.0) | verificado solo en codex exec | no en codex exec, que rechaza la confirmación; la interfaz interactiva de Codex aún no se ha probado |
| Clientes web, móviles y de conector remoto | no compatibles en 0.9.0 (solo stdio) | no aplicable |
Claude Code: el comando de una línea del inicio rápido (paso 5). Codex CLI: la entrada de config.toml, y el ajuste de aprobación que export_workspace necesita allí, están en docs/clients.md. Otros clientes que inician servidores stdio locales aún no se han probado con 0.9.0.
¿Sn1per está en otra máquina, o su cliente está en macOS o Windows? Consulte docs/remote.md para la receta SSH (verificada con un cliente OpenSSH de Linux; clientes de Windows y macOS documentados, no verificados), WSL2 (documentado, no verificado) y las recetas de Docker (documentadas, no verificadas).
El servidor detecta la edición y el motor desde la CLI de Sn1per en el host. "Verificado" significa que fue ejercitado por la ejecución de verificación de 0.9.0 el 2026-10-12; "esperado" significa que no hay ningún bloqueador conocido, pero no se ejercitó. Los resultados por herramienta, los modos de escaneo que se ejecutaron y las correcciones realizadas después de la ejecución están en docs/editions.md, junto con las tablas de modos y las notas por edición.