MCP SSH Manager

Servidor MCP local para administrar servidores SSH desde clientes compatibles con Model Context Protocol.

Funciones

• Ejecutar comandos remotos.
• Subir, bajar y sincronizar archivos.
• Abrir sesiones SSH persistentes y túneles.
• Revisar salud, procesos, servicios y logs.
• Crear backups y operar bases MySQL, PostgreSQL o MongoDB.
• Desplegar archivos con backup, permisos, owner y reinicio de servicio.
• Activar grupos de tools para reducir contexto.

Requisitos

• Node.js 18 o superior.
• npm install ejecutado en este repositorio.
• Acceso SSH a los servidores configurados.
• Opcional: rsync, sshpass, clientes de base de datos o Docker según la tool usada.

Inicio rápido

npm install
npm test

Crear .env:

SSH_SERVER_PROD_HOST=example.com
SSH_SERVER_PROD_USER=root
SSH_SERVER_PROD_PORT=22
SSH_SERVER_PROD_KEYPATH=C:\Users\me\.ssh\id_rsa
SSH_SERVER_PROD_DEFAULT_DIR=/var/www/app

Registrar el MCP en el cliente con stdio:

{
  "mcpServers": {
    "ssh-manager": {
      "command": "node",
      "args": ["D:/work/ssh-manager-mcp-server/src/index.js"],
      "env": {
        "SSH_ENV_PATH": "D:/work/ssh-manager-mcp-server/.env"
      }
    }
  }
}

No uses npm start en el cliente MCP. El cliente debe lanzar node src/index.js como proceso local por stdio.

Documentación

Leé en este orden:

1. Inicio rápido
2. Instalación
3. Índice de documentación
4. Instalación en clientes MCP
5. Gestión de tools
6. Modos de seguridad
7. Deploy
8. Backups
9. Alias y hooks

Configuración

El .env usa este formato:

SSH_SERVER_<NOMBRE>_HOST=hostname
SSH_SERVER_<NOMBRE>_USER=username
SSH_SERVER_<NOMBRE>_PASSWORD=password
SSH_SERVER_<NOMBRE>_KEYPATH=~/.ssh/id_rsa
SSH_SERVER_<NOMBRE>_PORT=22
SSH_SERVER_<NOMBRE>_DEFAULT_DIR=/path
SSH_SERVER_<NOMBRE>_SUDO_PASSWORD=password
SSH_SERVER_<NOMBRE>_PLATFORM=linux
SSH_SERVER_<NOMBRE>_MODE=unrestricted

Campos útiles:

• PASSWORD o KEYPATH: autenticación SSH.
• PASSPHRASE: passphrase de la clave.
• DEFAULT_DIR: directorio usado cuando la tool no recibe cwd.
• PLATFORM: linux por defecto, windows para OpenSSH en Windows.
• PROXYJUMP o PROXYCOMMAND: salto SSH o comando proxy.
• MODE, ALLOW_PATTERNS, DENY_PATTERNS, AUDIT_LOG: política por servidor.

También se puede usar TOML con SSH_CONFIG_PATH. Ver Instalación en clientes MCP.

Rutas de configuración

Orden para .env:

1. SSH_ENV_PATH
2. %USERPROFILE%\.ssh-manager\.env
3. .env del directorio actual
4. %USERPROFILE%\.env
5. .env junto al proyecto

TOML se carga desde SSH_CONFIG_PATH o ~/.codex/ssh-config.toml.

Desarrollo

npm test
npm run lint
npm run coverage
npm run validate
npx knip

npm run validate ejecuta lint, tests y cobertura. La cobertura global exige 85% para el código incluido por c8.

Seguridad

• No commitees .env, claves ni passwords.
• Preferí claves SSH antes que password.
• Usá readonly o restricted en servidores sensibles.
• Revisá Modos de seguridad antes de habilitar tools destructivas.