npm License: MIT

Un servidor MCP que proporciona a los asistentes de IA operaciones remotas completas de SSH/SFTP: gestión de sesiones, ejecución de comandos, shells interactivos, transferencias de archivos, reenvío de puertos y diagnósticos del sistema.

Funciona con Claude Desktop, VS Code + GitHub Copilot y cualquier cliente compatible con MCP.

Paquetes

Paquete	Descripción
`ssh-mcp-server`	Servidor MCP (49 herramientas) — CLI independiente y paquete npm
`ssh-mcp-vscode`	Extensión de VS Code — registra automáticamente el servidor con GitHub Copilot

Características

Gestión de sesiones — Conectar/desconectar/hacer ping con autenticación mediante contraseña o clave
Ejecución de comandos — Ejecutar comandos con captura de stdout/stderr, tiempos de espera y códigos de salida
Ejecución con sudo — Comandos elevados con contraseña inyectada vía stdin (nunca registrada en logs)
Trabajos en segundo plano — Comandos de larga duración con sondeo y cancelación
Shells interactivos — Shells PTY con lectura/escritura/redimensionamiento
Operaciones SFTP — Subir, descargar, leer, escribir, eliminar, listar, stat
Reenvío de puertos — Túneles SSH locales (-L) y remotos (-R)
Diagnósticos del sistema — SO, CPU, memoria, disco, red, carga, procesos
Búsqueda y análisis de archivos — Buscar archivos, grep de contenido, diff, tail, suma de comprobación
Gestión del servidor — Servicios, procesos, cron, diagnósticos de red, usuarios
Flujos de trabajo multi-host — Difusión de comandos, transferencia de archivos entre hosts, conexiones de salto/bastión, ejecución de scripts
Inteligencia de sesión — Instantáneas del sistema, diferencias de instantáneas, marcadores de conexión
Conciencia de contenedores — Listar, logs, exec para contenedores Docker/Podman
Registro de auditoría — Logs estructurados en NDJSON con filtrado

Inicio rápido

Independiente (npm)

npm install -g simple-ssh-mcp-server

Claude Desktop

Añadir a claude_desktop_config.json:

{
  "mcpServers": {
    "ssh": {
      "command": "npx",
      "args": ["ssh-mcp-server"],
      "env": {
        "SSH_MCP_MAX_CONNECTIONS": "10",
        "SSH_MCP_HOST_KEY_MODE": "accept"
      }
    }
  }
}

VS Code + GitHub Copilot

Instale la extensión SSH MCP para VS Code — el servidor se inicia automáticamente cuando se abre VS Code. Requiere VS Code 1.99+ y GitHub Copilot.

Herramientas (49)

Categoría	Herramientas
Sesiones	`ssh_connect`, `ssh_disconnect`, `ssh_list_sessions`, `ssh_session_ping`
Ejecución	`ssh_exec`, `ssh_sudo_exec`
Segundo plano	`ssh_exec_background`, `ssh_exec_poll`, `ssh_exec_poll_list`, `ssh_exec_cancel`
Shells	`ssh_shell_open`, `ssh_shell_write`, `ssh_shell_read`, `ssh_shell_resize`, `ssh_shell_close`, `ssh_shell_list`
SFTP	`ssh_sftp_list`, `ssh_sftp_upload`, `ssh_sftp_download`, `ssh_sftp_read`, `ssh_sftp_write`, `ssh_sftp_delete`, `ssh_sftp_stat`
Reenvío de puertos	`ssh_port_forward_local`, `ssh_port_forward_remote`, `ssh_port_forward_list`, `ssh_port_forward_remove`
Búsqueda de archivos	`ssh_find`, `ssh_grep`, `ssh_diff`, `ssh_tail`, `ssh_checksum`
Gestión del servidor	`ssh_service`, `ssh_process`, `ssh_cron`, `ssh_network`, `ssh_user`
Multi-host	`ssh_broadcast`, `ssh_transfer`, `ssh_jump_connect`, `ssh_script`
Inteligencia de sesión	`ssh_snapshot`, `ssh_snapshot_diff`, `ssh_bookmark`
Contenedores	`ssh_container_list`, `ssh_container_logs`, `ssh_container_exec`
Diagnósticos	`ssh_system_info`, `ssh_get_logs`

Configuración

Todos los ajustes se realizan mediante variables de entorno:

Variable	Predeterminado	Descripción
`SSH_MCP_MAX_CONNECTIONS`	`10`	Máximo de sesiones SSH concurrentes
`SSH_MCP_LOG_DIR`	`~/.ssh-mcp/logs`	Directorio de logs de auditoría
`SSH_MCP_DEFAULT_TERM`	`xterm-256color`	TERM predeterminado para shells PTY
`SSH_MCP_DEFAULT_COLS`	`220`	Ancho del terminal
`SSH_MCP_DEFAULT_ROWS`	`50`	Altura del terminal
`SSH_MCP_EXEC_TIMEOUT_MS`	`30000`	Tiempo de espera del comando (ms)
`SSH_MCP_HOST_KEY_MODE`	`accept`	Clave de host: `accept`, `strict`, `ask`
`SSH_MCP_ENV`	`development`	`production` establece por defecto claves de host `strict`

Consulte el README del servidor para obtener la referencia completa de configuración.

Seguridad

Contraseñas de sudo inyectadas vía stdin, nunca registradas en logs
Secuencias de escape ANSI eliminadas de la salida
El truncamiento de salida evita el uso ilimitado de memoria
Los keepalives de SSH detectan conexiones muertas
Plugin de seguridad ESLint + Gitleaks + CodeQL + Trivy en CI

Licencia

MIT

Simple SSH MCP Server