MCP SSH Manager - Gestión de servidores remotos SSH mediante el Protocolo de Contexto de Modelo (MCP) 🚀

Un servidor del Protocolo de Contexto de Modelo (MCP) que permite a Claude Code y OpenAI Codex gestionar múltiples conexiones SSH. Ejecuta comandos, transfiere archivos, gestiona bases de datos, crea copias de seguridad, supervisa el estado y automatiza tareas de DevOps en tus servidores, directamente desde tu asistente de IA.

🎉 Novedades en la v3.2.2

Corrección de instalación global y binario CLI (Publicado: 7 de abril de 2026)

• 🔧 Instalación global corregida: La resolución de rutas .env ahora utiliza una cadena de respaldo en lugar de __dirname codificado, funcionando correctamente con npm install -g (#16, #19)

  • Cadena de respaldo: ~/.ssh-manager/.env → cwd/.env → ~/.env → .env del proyecto

  • Crea automáticamente ~/.ssh-manager/.env en el primer ssh-manager server add

• 📦 CLI ssh-manager registrado como binario: npm install -g ahora crea los comandos mcp-ssh-manager y ssh-manager (#18)

• ⚡ Corrección de condición de carrera: La configuración del servidor ahora se carga completamente antes de que el servidor MCP acepte solicitudes

Related MCP server: MCP Server for FTP Access

Versiones anteriores

v3.2.0 - Soporte para ProxyJump / Bastion Host (18 de marzo de 2026)

• 🔀 Soporte para ProxyJump: Conéctate a servidores detrás de hosts bastión/salto con un campo de configuración PROXYJUMP simple (#15)

  • Encadena múltiples saltos (A → B → C) mediante conexiones recursivas

  • La detección de dependencias circulares evita bucles infinitos

  • Todas las herramientas funcionan de forma transparente a través de hosts de salto

• 📦 Soporte para npx corregido: npx mcp-ssh-manager ahora funciona correctamente (#14)

v3.1.5 - Soporte para SSH Agent y frases de contraseña (5 de marzo de 2026)

• 🔑 Soporte para SSH Agent: Utiliza automáticamente ssh-agent cuando SSH_AUTH_SOCK está disponible; las claves protegidas por frase de contraseña funcionan de forma transparente

• 🔐 Configuración de frase de contraseña: Nuevo campo passphrase tanto para formatos .env como TOML

Gracias a @snjax por la contribución original (#12).

v3.1.4 - Soporte para hosts SSH de Windows (22 de febrero de 2026)

• 🪟 Corrección de host SSH de Windows: Los comandos ya no fallan en hosts Windows que ejecutan OpenSSH (#10)

• Nuevo campo de configuración platform por servidor (SSH_SERVER_FOO_PLATFORM=windows o platform = "windows" en TOML)

• Cuando platform=windows, se omite el contenedor de comandos timeout/sh -c de Linux y se utiliza el tiempo de espera nativo de la biblioteca SSH

• Todas las herramientas (ssh_execute, ssh_tail, ssh_monitor, ssh_deploy, ssh_execute_sudo, ssh_group_execute) son conscientes de la plataforma

v3.1.2 - Corrección de compatibilidad con Windows (9 de febrero de 2026)

• 🪟 Soporte para Windows: Se corrigió un bloqueo en Windows donde process.env.HOME no estaba definido (#8)

• Ahora utiliza os.homedir() para compatibilidad multiplataforma (Linux, macOS, Windows)

v3.1.0 - Sistema de activación de herramientas (15 de noviembre de 2025)

🎯 Optimización del uso de contexto

• Reducción del 92% del contexto: Habilita solo las herramientas que necesitas (modo mínimo: 5 herramientas frente a las 37 totales)

• CLI de gestión de herramientas: ssh-manager tools list/configure/enable/disable

• 6 grupos de herramientas: Core, Sesiones, Monitorización, Copias de seguridad, Base de datos, Avanzado

• Exportación de auto-aprobación: Genera configuraciones de auto-aprobación para Claude Code

v3.0.0 - Plataforma Enterprise DevOps (1 de octubre de 2025)

Esta versión añade 12 nuevas herramientas MCP que transforman SSH Manager en una plataforma integral de automatización DevOps:

💾 Sistema de copia de seguridad y restauración (4 herramientas)

• Copias de seguridad automatizadas para MySQL, PostgreSQL, MongoDB y sistemas de archivos

• Programación inteligente con integración cron y políticas de retención

• Restauración con un clic con soporte entre bases de datos

• Seguimiento de metadatos para auditoría y cumplimiento

🏥 Salud y monitorización (4 herramientas)

• Comprobaciones de salud en tiempo real con métricas de CPU, RAM, disco y red

• Monitorización de servicios para nginx, mysql, docker y servicios personalizados

• Gestión de procesos con ordenación por CPU/RAM y capacidades de finalización

• Umbrales de alerta con notificaciones configurables

🗄️ Gestión de bases de datos (4 herramientas)

• Volcados de base de datos seguros con compresión y exportaciones selectivas

• Importaciones de base de datos con descompresión automática

• Exploración de esquemas listando bases de datos, tablas y colecciones

• Consultas seguras con prevención de inyección SQL (solo SELECT)

📊 Total: 37 herramientas MCP | 🔧 ~4,100 líneas de código añadidas | ✅ Listo para producción

Leer registro de cambios completo →

📑 Tabla de contenidos

• Características

• Gestión de herramientas

• Requisitos previos

• Inicio rápido - Claude Code

• Inicio rápido - OpenAI Codex

• Herramientas MCP disponibles

• Configuración

• Ejemplos de uso

• Seguridad

• Solución de problemas

• Limitaciones conocidas

• Contribución

• Licencia

🌟 Características

Características principales

• 🔗 Múltiples conexiones SSH - Gestiona servidores SSH ilimitados desde una única interfaz

• 🔐 Autenticación segura - Soporte para contraseña, clave SSH y autenticación ssh-agent (incluyendo claves protegidas por frase de contraseña)

• 🔀 ProxyJump / Bastion Host - Conéctate a servidores detrás de hosts de salto con soporte de múltiples saltos encadenados

• 📁 Operaciones de archivo - Sube y descarga archivos entre sistemas locales y remotos

• ⚡ Ejecución de comandos - Ejecuta comandos en servidores remotos con soporte de directorio de trabajo

• 📂 Directorios predeterminados - Establece directorios de trabajo predeterminados por servidor para mayor comodidad

• 🎯 Configuración sencilla - Configuración simple de archivo .env con herramienta de configuración guiada

Características de Enterprise DevOps (v3.0) 🎉

• 💾 Copia de seguridad y restauración - Copias de seguridad automatizadas para MySQL, PostgreSQL, MongoDB y archivos

• 🏥 Monitorización de salud - Comprobaciones de salud del servidor en tiempo real (CPU, RAM, disco, servicios)

• 🗄️ Gestión de bases de datos - Operaciones de base de datos seguras con prevención de inyección SQL

• 📊 Gestión de procesos - Supervisa y controla los procesos del servidor

• ⚠️ Alertas inteligentes - Umbrales de salud y notificaciones configurables

Características de la v2.0

• 🚀 Bash CLI - CLI Bash pura ultrarrápida para la gestión de servidores

• 📊 Registro avanzado - Sistema de registro integral con niveles e historial

• 🔄 Integración con Rsync - Sincronización de archivos bidireccional con soporte rsync

• 💻 Sesiones persistentes - Mantiene el contexto del shell a través de múltiples comandos

• 👥 Grupos de servidores - Ejecuta comandos en múltiples servidores simultáneamente

• 🔧 Túneles SSH - Reenvío de puertos local/remoto y soporte de proxy SOCKS

• 📈 Monitorización del sistema - Monitorización en tiempo real de CPU, memoria, disco y red

• 🏷️ Alias de servidor - Usa alias cortos en lugar de nombres de servidor completos

• 🚀 Despliegue inteligente - Despliegue de archivos automatizado con gestión de permisos

• 🔑 Soporte Sudo - Ejecuta comandos con privilegios sudo de forma segura

• 📝 Soporte OpenAI Codex - Compatible con OpenAI Codex mediante configuración TOML

⚙️ Gestión de herramientas y optimización de contexto

NUEVO en la v3.1: ¡Reduce el uso de contexto de Claude Code en un 92% con la gestión de activación de herramientas!

MCP SSH Manager incluye 37 herramientas organizadas en 6 grupos. Por defecto, todas las herramientas están habilitadas, pero puedes optimizar para tu flujo de trabajo específico:

Configuración rápida

# Interactive configuration wizard
ssh-manager tools configure

# View current configuration
ssh-manager tools list

# Enable/disable specific groups
ssh-manager tools enable monitoring
ssh-manager tools disable backup

Modos de configuración

Grupos de herramientas

• Core (5 herramientas) - Siempre habilitadas: listar, ejecutar, subir, descargar, sincronizar

• Sesiones (4 herramientas) - Sesiones SSH persistentes

• Monitorización (6 herramientas) - Comprobaciones de salud, estado del servicio, gestión de procesos

• Copia de seguridad (4 herramientas) - Copias de seguridad de bases de datos y archivos

• Base de datos (4 herramientas) - Operaciones MySQL, PostgreSQL, MongoDB

• Avanzado (14 herramientas) - Despliegue, sudo, túneles, grupos, alias, etc.

Beneficios

• Reducción del 92% del contexto en modo mínimo (~40k tokens ahorrados)

• Menos avisos de aprobación en Claude Code

• Carga más rápida e interfaz más limpia

• Exportación de configuración de auto-aprobación para Claude Code

📖 Guía completa de gestión de herramientas →

📋 Requisitos previos

• Node.js (v18 o superior)

• npm (incluido con Node.js)

• Plataformas: Linux, macOS, Windows

• Para Claude Code: CLI de Claude Code instalada

• Para OpenAI Codex: CLI de Codex configurada

• Bash 4.0+ (para herramientas de gestión CLI)

• rsync (para sincronización de archivos)

• sshpass (opcional, para rsync con autenticación por contraseña)

  • macOS: brew install hudochenkov/sshpass/sshpass

  • Linux: apt-get install sshpass

🚀 Inicio rápido - Claude Code

1. Instalar MCP SSH Manager

Opción A: Instalar desde npm (recomendado)

# Install globally from npm
npm install -g mcp-ssh-manager

# Or install locally
npx mcp-ssh-manager

Opción B: Instalar desde el código fuente

# Clone and install
git clone https://github.com/bvisible/mcp-ssh-manager.git
cd mcp-ssh-manager
npm install

# Install the Bash CLI
cd cli && ./install.sh

# Configure your first server
ssh-manager server add

2. Instalar en Claude Code

# For personal use (current user only)
claude mcp add ssh-manager node /path/to/mcp-ssh-manager/src/index.js

# For team sharing (creates .mcp.json in project)
claude mcp add ssh-manager --scope project node /path/to/mcp-ssh-manager/src/index.js

# For all your projects
claude mcp add ssh-manager --scope user node /path/to/mcp-ssh-manager/src/index.js

3. Configurar auto-aprobación (Opcional pero recomendado)

Para evitar que se te solicite aprobación en cada comando SSH, añade la configuración de auto-aprobación:

Edita ~/.config/claude-code/claude_code_config.json:

{
  "mcpServers": {
    "ssh-manager": {
      "command": "node",
      "args": ["/path/to/mcp-ssh-manager/src/index.js"],
      "autoApprove": [
        "mcp__ssh-manager__ssh_execute",
        "mcp__ssh-manager__ssh_list_servers",
        "mcp__ssh-manager__ssh_upload",
        "mcp__ssh-manager__ssh_download",
        "mcp__ssh-manager__ssh_sync",
        "mcp__ssh-manager__ssh_alias"
      ]
    }
  }
}

Importante: Reinicia Claude Code después de realizar este cambio.

Para la auto-aprobación completa de todas las herramientas SSH, consulta la lista completa en examples/claude-code-config.example.json.

4. ¡Empieza a usarlo!

En Claude Code, ahora puedes:

"List all my SSH servers"
"Execute 'ls -la' on production server"  # Uses default directory if set
"Run 'docker ps' on staging"
"Upload config.json to production:/etc/app/config.json"
"Download logs from staging:/var/log/app.log"

Con directorios predeterminados: Si estableces /var/www/html como predeterminado para producción, estos comandos son equivalentes:

• "Run 'ls' on production" → se ejecuta en /var/www/html

• "Run 'ls' on production in /tmp" → se ejecuta en /tmp (anula el predeterminado)

🚀 Inicio rápido - OpenAI Codex

1. Instalar MCP SSH Manager

La misma instalación que Claude Code (ver arriba), luego configura para Codex:

# Set up Codex integration
ssh-manager codex setup

# Migrate existing servers to TOML format (if you have .env servers)
ssh-manager codex migrate

# Test the integration
ssh-manager codex test

2. Configuración manual (Opcional)

Si prefieres la configuración manual, añade a `~/.