ssh-mcp-server: SSH remoto sicuro per flussi di lavoro AI

Cosa fa il server MCP “ssh-mcp-server”?

ssh-mcp-server è uno strumento di interconnessione che consente ad assistenti AI e ad altre applicazioni compatibili con il Model Context Protocol (MCP) di eseguire comandi SSH remoti tramite un’interfaccia standardizzata. Agendo come intermediario sicuro, permette agli assistenti AI di operare in sicurezza su server remoti, eseguire comandi e recuperare risultati senza esporre direttamente le credenziali SSH ai modelli AI. Il server supporta diversi metodi di connessione SSH sicura, tra cui autenticazione tramite password o chiave privata (con supporto opzionale per passphrase). Offre controlli di sicurezza sui comandi tramite meccanismi di blacklist e whitelist, e consente il trasferimento bidirezionale di file tra server locali e remoti. ssh-mcp-server è progettato per un’integrazione fluida nei flussi di sviluppo, offrendo a sviluppatori e agenti AI accesso potente e controllato ai sistemi remoti per attività come manutenzione, automazione e deployment.

Elenco dei Prompt

Nessun template di prompt è esplicitamente menzionato nella documentazione disponibile.

Elenco delle Risorse

Nessuna risorsa esplicita è documentata nei file o nel README disponibili.

Elenco degli Strumenti

• execute-command
  Strumento di esecuzione comandi: esegui comandi SSH su server remoti e ottieni i risultati.
• upload
  Strumento di caricamento file: carica file locali in posizioni specificate su server remoti.
• download
  Strumento di scaricamento file: scarica file dai server remoti in posizioni locali specificate.

Casi d’Uso di questo MCP Server

• Gestione Remota dei Server
  Permette a sviluppatori o agenti AI di eseguire in sicurezza comandi amministrativi o di manutenzione su server remoti, come riavviare servizi, controllare log o aggiornare software.
• Deployment Automatizzato
  Facilita pipeline di deployment automatico permettendo a script o workflow AI di inviare codice, eseguire script di setup o gestire applicazioni tramite SSH.
• Sincronizzazione File
  Supporta il trasferimento bidirezionale di file, rendendo semplice caricare file di configurazione o scaricare log e risultati dai server remoti.
• Auditing di Sicurezza
  Permette l’esecuzione controllata di comandi di auditing (usando whitelist/blacklist), abilitando controlli di sicurezza e validazioni di conformità senza rischi per il sistema.
• Isolamento delle Credenziali
  Garantisce operatività sicura assicurando che le credenziali SSH non siano mai esposte al modello AI, riducendo i rischi in ambienti sensibili.

Come configurarlo

Windsurf

1. Prerequisiti: Assicurati di avere Node.js e npx installati.
2. Individua la Configurazione: Apri il file di configurazione di Windsurf.
3. Aggiungi il server MCP: Inserisci il seguente snippet JSON nell’oggetto mcpServers:

   {
     "mcpServers": {
       "ssh-mpc-server": {
         "command": "npx",
         "args": [
           "-y",
           "@fangjunjie/ssh-mcp-server",
           "--host 192.168.1.1",
           "--port 22",
           "--username root",
           "--password pwd123456"
         ]
       }
     }
   }
   

4. Salva e Riavvia: Salva il file e riavvia Windsurf.
5. Verifica la Configurazione: Testa eseguendo un semplice comando SSH tramite l’interfaccia MCP.

Claude

1. Prerequisiti: Node.js e npx devono essere disponibili.
2. Individua la Configurazione: Apri la configurazione mcpServers di Claude.
3. Aggiungi il server MCP: Usa la seguente configurazione:

   {
     "mcpServers": {
       "ssh-mpc-server": {
         "command": "npx",
         "args": [
           "-y",
           "@fangjunjie/ssh-mcp-server",
           "--host 192.168.1.1",
           "--port 22",
           "--username root",
           "--privateKey ~/.ssh/id_rsa"
         ]
       }
     }
   }
   

4. Salva e Riavvia: Salva le modifiche e riavvia Claude.
5. Verifica la Configurazione: Prova un comando di test tramite l’integrazione MCP di Claude.

Cursor

1. Prerequisiti: Installa Node.js e npx.
2. Modifica la Configurazione: Vai nella directory di configurazione di Cursor e modifica il file appropriato.
3. Aggiungi il server MCP: Inserisci:

   {
     "mcpServers": {
       "ssh-mpc-server": {
         "command": "npx",
         "args": [
           "-y",
           "@fangjunjie/ssh-mcp-server",
           "--host 192.168.1.1",
           "--port 22",
           "--username root",
           "--privateKey ~/.ssh/id_rsa",
           "--passphrase pwd123456"
         ]
       }
     }
   }
   

4. Riavvia Cursor: Salva e riavvia Cursor.
5. Verifica: Usa il command palette MCP per verificare la connettività SSH remota.

Cline

1. Prerequisiti: Assicurati che Node.js e npx siano installati.
2. Apri la Configurazione: Modifica la sezione mcpServers nella configurazione di Cline.
3. Aggiungi il server MCP: Aggiungi:

   {
     "mcpServers": {
       "ssh-mpc-server": {
         "command": "npx",
         "args": [
           "-y",
           "@fangjunjie/ssh-mcp-server",
           "--host 192.168.1.1",
           "--port 22",
           "--username root",
           "--password pwd123456",
           "--whitelist ^ls( .*)?,^cat .*,^df.*"
         ]
       }
     }
   }
   

4. Salva e Riavvia: Salva la configurazione e riavvia Cline.
5. Testa la Connessione: Valida eseguendo un comando consentito.

Proteggere le API Key

Per evitare di esporre le credenziali nei file di configurazione, usa variabili d’ambiente:

{
  "mcpServers": {
    "ssh-mpc-server": {
      "command": "npx",
      "args": [
        "-y",
        "@fangjunjie/ssh-mcp-server",
        "--host ${SSH_HOST}",
        "--port ${SSH_PORT}",
        "--username ${SSH_USER}",
        "--password ${SSH_PASSWORD}"
      ],
      "env": {
        "SSH_HOST": "192.168.1.1",
        "SSH_PORT": "22",
        "SSH_USER": "root",
        "SSH_PASSWORD": "pwd123456"
      }
    }
  }
}

Come utilizzare questo MCP nei flussi

Utilizzo di MCP in FlowHunt

Per integrare server MCP nel tuo workflow FlowHunt, inizia aggiungendo il componente MCP al tuo flusso e collegandolo al tuo agente AI:

Clicca sul componente MCP per aprire il pannello di configurazione. Nella sezione di configurazione MCP di sistema, inserisci i dettagli del tuo server MCP usando questo formato JSON:

{
  "ssh-mpc-server": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Una volta configurato, l’agente AI potrà usare questo MCP come strumento con accesso a tutte le sue funzioni e capacità. Ricorda di cambiare “ssh-mpc-server” con il nome effettivo del tuo MCP server e di aggiornare l’URL.

Panoramica

La nostra opinione

ssh-mcp-server offre funzionalità SSH essenziali come server MCP, con un focus su sicurezza e praticità. Il set di strumenti è pratico per molti scenari di sviluppo e automazione, ma manca di funzionalità avanzate come risorse, template di prompt o supporto sampling. La documentazione è chiara per configurazione e utilizzo operativo. Nel complesso, è un’utilità solida e specializzata per accesso SSH sicuro tramite MCP.

MCP Score

PUNTEGGIO: 5/10

ssh-mcp-server ottiene un punteggio moderato, eccellendo nell’integrazione SSH sicura e nell’esposizione degli strumenti principali, ma manca di supporto per risorse e prompt, e non documenta funzionalità root o sampling. La licenza open source e la configurazione chiara sono dei punti a favore, ma rimane una soluzione MCP focalizzata, più che completa.