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. Usa el Sn1per MCP Server únicamente contra sistemas que poseas o para los que tengas permiso explícito, por escrito, de probar, 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 usas con la instalación de Sn1per en tu propio host Linux. Se ejecuta localmente sobre stdio junto a Sn1per, rechaza solicitudes de escaneo para objetivos fuera del alcance que configures (consulta los límites), registra cada solicitud de escaneo, cancelación, eliminación y exportación que ejecuta 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 por defecto. Es compatible con Sn1per Community Edition 9.x y el motor 11.x usado por 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 botín permanece allí, y los resultados de las herramientas solo salen del host a través de tu cliente MCP y el servicio de modelo que este utiliza. 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 usas 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, por lo que --check ve exactamente lo que ejecutará el cliente.
Instala pipx, 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.