npm License: MIT

Ein MCP-Server, der KI-Assistenten vollständige SSH/SFTP-Fernzugriffsfunktionen bietet – Sitzungsverwaltung, Befehlsausführung, interaktive Shells, Dateiübertragungen, Portweiterleitung und Systemdiagnose.

Funktioniert mit Claude Desktop, VS Code + GitHub Copilot und jedem MCP-kompatiblen Client.

Pakete

Paket	Beschreibung
`ssh-mcp-server`	MCP-Server (49 Tools) – eigenständige CLI & npm-Paket
`ssh-mcp-vscode`	VS Code-Erweiterung – registriert den Server automatisch bei GitHub Copilot

Funktionen

Sitzungsverwaltung — Verbinden/Trennen/Ping mit Passwort- oder schlüsselbasierter Authentifizierung
Befehlsausführung — Ausführen von Befehlen mit stdout/stderr-Erfassung, Timeouts und Exit-Codes
Sudo-Ausführung — Erhöhte Rechte für Befehle mit Passwort-Eingabe über stdin (wird nie protokolliert)
Hintergrundprozesse — Lang laufende Befehle mit Polling und Abbruchmöglichkeit
Interaktive Shells — PTY-Shells mit Lese-/Schreib-/Größenänderungsfunktionen
SFTP-Operationen — Hochladen, Herunterladen, Lesen, Schreiben, Löschen, Auflisten, Stat
Portweiterleitung — Lokale (-L) und entfernte (-R) SSH-Tunnel
Systemdiagnose — Betriebssystem, CPU, Arbeitsspeicher, Festplatte, Netzwerk, Auslastung, Prozesse
Dateisuche & Analyse — Dateien finden, Inhalte mit grep durchsuchen, diff, tail, Prüfsummen
Serververwaltung — Dienste, Prozesse, Cron, Netzwerkdiagnose, Benutzer
Multi-Host-Workflows — Befehle übertragen, Dateien zwischen Hosts verschieben, Jump/Bastion-Verbindungen, Skriptausführung
Sitzungsintelligenz — System-Snapshots, Snapshot-Diffs, Verbindungs-Lesezeichen
Container-Unterstützung — Auflisten, Logs, Exec für Docker/Podman-Container
Audit-Logging — NDJSON-strukturierte Logs mit Filterfunktion

Schnellstart

Eigenständig (npm)

npm install -g simple-ssh-mcp-server

Claude Desktop

In claude_desktop_config.json hinzufügen:

{
  "mcpServers": {
    "ssh": {
      "command": "npx",
      "args": ["ssh-mcp-server"],
      "env": {
        "SSH_MCP_MAX_CONNECTIONS": "10",
        "SSH_MCP_HOST_KEY_MODE": "accept"
      }
    }
  }
}

VS Code + GitHub Copilot

Installieren Sie die SSH MCP VS Code-Erweiterung — der Server startet automatisch beim Start von VS Code. Erfordert VS Code 1.99+ und GitHub Copilot.

Tools (49)

Kategorie	Tools
Sitzungen	`ssh_connect`, `ssh_disconnect`, `ssh_list_sessions`, `ssh_session_ping`
Exec	`ssh_exec`, `ssh_sudo_exec`
Hintergrund	`ssh_exec_background`, `ssh_exec_poll`, `ssh_exec_poll_list`, `ssh_exec_cancel`
Shells	`ssh_shell_open`, `ssh_shell_write`, `ssh_shell_read`, `ssh_shell_resize`, `ssh_shell_close`, `ssh_shell_list`
SFTP	`ssh_sftp_list`, `ssh_sftp_upload`, `ssh_sftp_download`, `ssh_sftp_read`, `ssh_sftp_write`, `ssh_sftp_delete`, `ssh_sftp_stat`
Portweiterleitung	`ssh_port_forward_local`, `ssh_port_forward_remote`, `ssh_port_forward_list`, `ssh_port_forward_remove`
Dateisuche	`ssh_find`, `ssh_grep`, `ssh_diff`, `ssh_tail`, `ssh_checksum`
Serververwaltung	`ssh_service`, `ssh_process`, `ssh_cron`, `ssh_network`, `ssh_user`
Multi-Host	`ssh_broadcast`, `ssh_transfer`, `ssh_jump_connect`, `ssh_script`
Sitzungsintelligenz	`ssh_snapshot`, `ssh_snapshot_diff`, `ssh_bookmark`
Container	`ssh_container_list`, `ssh_container_logs`, `ssh_container_exec`
Diagnose	`ssh_system_info`, `ssh_get_logs`

Konfiguration

Alle Einstellungen erfolgen über Umgebungsvariablen:

Variable	Standard	Beschreibung
`SSH_MCP_MAX_CONNECTIONS`	`10`	Maximale gleichzeitige SSH-Sitzungen
`SSH_MCP_LOG_DIR`	`~/.ssh-mcp/logs`	Verzeichnis für Audit-Logs
`SSH_MCP_DEFAULT_TERM`	`xterm-256color`	Standard-TERM für PTY-Shells
`SSH_MCP_DEFAULT_COLS`	`220`	Terminalbreite
`SSH_MCP_DEFAULT_ROWS`	`50`	Terminalhöhe
`SSH_MCP_EXEC_TIMEOUT_MS`	`30000`	Befehls-Timeout (ms)
`SSH_MCP_HOST_KEY_MODE`	`accept`	Host-Key: `accept`, `strict`, `ask`
`SSH_MCP_ENV`	`development`	`production` setzt standardmäßig `strict` für Host-Keys

Siehe Server-README für die vollständige Konfigurationsreferenz.

Sicherheit

Sudo-Passwörter werden über stdin eingegeben und niemals protokolliert
ANSI-Escape-Sequenzen werden aus der Ausgabe entfernt
Ausgabebegrenzung verhindert unbegrenzten Speicherverbrauch
SSH-Keepalives erkennen unterbrochene Verbindungen
ESLint-Sicherheits-Plugin + Gitleaks + CodeQL + Trivy in der CI

Lizenz

MIT

Simple SSH MCP Server