ssh-mcp-server: Bezpečný vzdialený SSH pre AI pracovné postupy

Čo robí MCP server “ssh-mcp-server”?

ssh-mcp-server je prepojovací nástroj, ktorý umožňuje AI asistentom a ďalším aplikáciám podporujúcim Model Context Protocol (MCP) vykonávať vzdialené SSH príkazy cez štandardizované rozhranie. Ako bezpečný sprostredkovateľ umožňuje AI asistentom bezpečne obsluhovať vzdialené servery, vykonávať príkazy a získavať výsledky bez priameho vystavenia SSH prihlasovacích údajov AI modelom. Server podporuje viacero bezpečných metód SSH pripojenia vrátane overenia heslom a súkromným kľúčom (s voliteľnou podporou passphrase). Poskytuje aj bezpečnostné kontroly príkazov cez blacklist a whitelist mechanizmy a umožňuje obojsmerný prenos súborov medzi lokálnym a vzdialeným serverom. ssh-mcp-server je navrhnutý na bezproblémovú integráciu do vývojových procesov, poskytuje vývojárom a AI agentom výkonný a kontrolovaný prístup k vzdialeným systémom na úlohy ako údržba, automatizácia a nasadzovanie.

Zoznam promptov

V dostupnej dokumentácii nie sú explicitne uvedené žiadne šablóny promptov.

Zoznam zdrojov

V dostupných súboroch ani README nie sú explicitne zdokumentované žiadne zdroje.

Zoznam nástrojov

• execute-command
  Nástroj na vykonávanie príkazov: Spúšťajte SSH príkazy na vzdialených serveroch a získajte výsledky.
• upload
  Nástroj na nahrávanie súborov: Nahrajte lokálne súbory na určené miesta na vzdialených serveroch.
• download
  Nástroj na sťahovanie súborov: Stiahnite súbory zo vzdialených serverov na lokálne určené miesta.

Príklady použitia tohto MCP servera

• Vzdialená správa serverov
  Umožňuje vývojárom alebo AI agentom bezpečne vykonávať administratívne alebo údržbové príkazy na vzdialených serveroch, napríklad reštartovanie služieb, kontrolu logov alebo aktualizáciu softvéru.
• Automatizované nasadzovanie
  Uľahčuje automatizované nasadzovacie pipeline tým, že skriptom alebo AI workflow umožňuje nahrávať kód, spúšťať inštalačné skripty či spravovať aplikácie cez SSH.
• Synchronizácia súborov
  Podporuje obojsmerný prenos súborov, čo uľahčuje nahrávanie konfiguračných súborov alebo sťahovanie logov a výsledkov zo vzdialených serverov.
• Bezpečnostné audity
  Umožňuje kontrolované vykonávanie auditných príkazov (s využitím whitelist/blacklist), čím umožňuje bezpečné bezpečnostné kontroly a overovanie súladu bez rizika poškodenia systému.
• Izolácia prihlasovacích údajov
  Zabezpečuje bezpečnú prevádzku tým, že SSH prihlasovacie údaje nie sú nikdy vystavené AI modelu, čo znižuje riziko v citlivých prostrediach.

Ako to nastaviť

Windsurf

1. Predpoklady: Uistite sa, že máte nainštalované Node.js a npx.
2. Nájdite konfiguráciu: Otvorte svoj konfiguračný súbor Windsurf.
3. Pridajte MCP server: Vložte nasledujúci JSON úryvok do objektu 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. Uložte a reštartujte: Uložte súbor a reštartujte Windsurf.
5. Overte nastavenie: Otestujte spustením jednoduchého SSH príkazu cez MCP rozhranie.

Claude

1. Predpoklady: Node.js a npx by mali byť dostupné.
2. Nájdite konfiguráciu: Otvorte konfiguráciu mcpServers v Claude.
3. Pridajte MCP server: Použite túto konfiguráciu:

   {
     "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. Uložte a reštartujte: Uložte zmeny a reštartujte Claude.
5. Overte nastavenie: Skúste testovací príkaz cez MCP integráciu Claude.

Cursor

1. Predpoklady: Nainštalujte Node.js a npx.
2. Upravte konfiguráciu: Prejdite do konfiguračného adresára Cursor a upravte príslušný súbor.
3. Pridajte MCP server: Vložte:

   {
     "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. Reštartujte Cursor: Uložte a reštartujte Cursor.
5. Overte: Použite MCP paletu príkazov na overenie SSH konektivity.

Cline

1. Predpoklady: Uistite sa, že máte nainštalované Node.js a npx.
2. Otvorte konfiguráciu: Upravte sekciu mcpServers v konfigurácii Cline.
3. Pridajte MCP server: Pridajte:

   {
     "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. Uložte a reštartujte: Uložte konfiguráciu a reštartujte Cline.
5. Otestujte pripojenie: Overte spustením povoleného príkazu.

Zabezpečenie API kľúčov

Aby ste predišli odhaleniu prihlasovacích údajov v konfiguračných súboroch, použite environmentálne premenné:

{
  "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"
      }
    }
  }
}

Ako používať tento MCP vo flow

Použitie MCP vo FlowHunt

Na integráciu MCP serverov do svojho FlowHunt pracovného toku začnite pridaním MCP komponentu do svojho flow a pripojte ho k AI agentovi:

Kliknite na MCP komponent pre otvorenie konfiguračného panela. V systémovej MCP konfigurácii vložte údaje o svojom MCP serveri v tomto JSON formáte:

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

Po nakonfigurovaní môže AI agent využívať tento MCP ako nástroj so všetkými jeho funkciami a možnosťami. Nezabudnite zmeniť “ssh-mpc-server” na skutočný názov vášho MCP servera a aktualizovať URL.

Prehľad

Náš názor

ssh-mcp-server poskytuje základné SSH funkcie ako MCP server so zameraním na bezpečnosť a pohodlie. Jeho sada nástrojov je praktická pre množstvo vývojových a automatizačných scenárov, ale chýbajú pokročilé funkcie ako zdroje, šablóny promptov alebo sampling podpora. Dokumentácia je jasná pre nastavenie aj prevádzku. Celkovo ide o solídny a špecializovaný nástroj na bezpečný SSH prístup cez MCP.

MCP skóre

HODNOTENIE: 5/10

ssh-mcp-server dosahuje priemerné skóre, vyniká v bezpečnej SSH integrácii a sprístupnení základných nástrojov, ale chýba mu podpora zdrojov a promptov a nedokumentuje rooty ani sampling funkcie. Jeho open-source licencia a jasné nastavenie sú pozitíva, no ostáva zameraný skôr na úzku, než komplexnú MCP funkcionalitu.