Servidor MCP remoto SSH

Acceso remoto SSH para clientes compatibles con MCP a través del Protocolo de Contexto de Modelo (MCP).

Inicio rápido

1. Instalar:

   pip install -r requirements.txt

2. Añadir el MCP en Claude Desktop o Claude Code:

   Usa tu configuración de MCP y establece el comando en:

   python3 adremote-mcp/ssh_mcp_server.py

   o

   python.exe adremote-mcp/ssh_mcp_server.py

3. Añadir el MCP en Codex:

   Añade el mismo servidor a tu configuración de MCP de Codex:

   python3 adremote-mcp/ssh_mcp_server.py

4. Configuración automática:

   Descarga este repositorio, ejecuta Claude o Codex y pídele que añada esta carpeta como un servidor MCP global. Después de eso, puedes usarlo directamente desde el chat.

Características

• Funciona con clientes compatibles con MCP en Windows y Linux

• Conéctate a servidores remotos mediante SSH

• Soporte nativo para jump-host / bastion SSH

• Ejecuta comandos de forma remota

• Sube/descarga archivos mediante SFTP

• Gestiona múltiples conexiones

• Monitorización de estado

Ejemplos de uso

Conectar con contraseña:

Connect to 192.168.1.100 with username ubuntu and password mypass

o en forma abreviada:

ssh 192.168.1.100:22 ubuntu mypass

El MCP primero prueba la conexión SSH con tu nombre de usuario y contraseña. Si el inicio de sesión funciona, genera o instala una clave SSH, guarda la credencial basada en clave localmente y no guarda la contraseña. La contraseña solo se utiliza la primera vez.

Conectar con contraseña para una sesión única:

ssh 192.168.1.100:22 ubuntu mypass, save_credentials false

Esto mantiene solo la conexión en vivo. No se guarda ninguna credencial reutilizable y no se intenta el arranque automático de claves.

Conectar más tarde usando el nombre guardado:

ssh saved-name

Después de la primera configuración exitosa, simplemente usa el nombre de la credencial guardada para volver a conectar.

Conectar a través de un jump host:

Usa el objeto jump_host en ssh_connect o ssh_save_credentials:

{
  "hostname": "10.0.2.15",
  "username": "ubuntu",
  "private_key_path": "~/.ssh/id_ed25519",
  "jump_host": {
    "hostname": "203.0.113.10",
    "username": "bastion",
    "private_key_path": "~/.ssh/id_ed25519",
    "port": 22
  }
}

Esto utiliza un túnel SSH nativo hacia el host de destino y las credenciales guardadas conservan la misma configuración de jump-host. Para credenciales guardadas reutilizables, el jump host debe usar private_key_path en lugar de una contraseña.

Ejecutar comandos:

Upload local file.txt to /home/user/ on the server
Download /var/log/app.log from the server

Transferencias de archivos:

Upload local file.txt to /home/user/ on the server
Download /var/log/app.log from the server

Estado de la conexión e inventario:

Check health of all SSH connections
Show me all active SSH connections

Requisitos

• Python 3.10+

• paramiko

• mcp

Última actualización

La versión 1.0.1 añade flujos de trabajo SSH diarios más seguros y prácticos:

• Los inicios de sesión directos siguen guardando credenciales reutilizables por defecto, pero save_credentials=false ahora permite optar por no hacerlo también para sesiones con contraseña

• Los flujos de credenciales guardadas ahora incluyen asistentes para conectar, guardar, listar, eliminar y configurar claves manualmente

• Las reglas de confianza de host y transferencia de archivos son más estrictas, con restricciones de root local y fijación de host basada en la confianza al primer uso

• Se admiten conexiones nativas de jump-host tanto para sesiones en vivo como para credenciales guardadas

• Las credenciales guardadas se basan en claves, por lo que no se requiere una contraseña maestra para el uso normal

• Las rutas de claves privadas guardadas manualmente se validan cuando las guardas, no más tarde en la primera conexión

Soporte

Contáctame para colaborar.