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.

Related MCP server: acp-mcp

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.