ssh-mcp v4.0

MCP-Server für persistente SSH-Arbeit auf Linux-Hosts und Netzwerkgeräten.

Funktionen

• Persistente SSH-Verbindungen mit automatischer Wiederverbindung

• Sichere Speicherung von Anmeldedaten über Windows Credential Manager

• Unterstützung für Netzwerkgeräte: Cisco IOS/IOS-XE/XR, MikroTik, FortiGate, Juniper

• Konfigurationsverwaltung: Backup, Wiederherstellung und Diff für Netzwerkgeräte

• SFTP: Hochladen, Herunterladen, Auflisten entfernter Dateien

• SSH-Tunnel: persistente Portweiterleitung

• Ratenbegrenzung: verhindert Gerätesättigung (mindestens 100 ms zwischen Befehlen)

• Intelligente Verbindung: Verwenden Sie ssh_connect(alias='vps'), um gespeicherte Anmeldedaten automatisch zu laden.

Related MCP server: SSH MCP Server

Schnellstart

1. Server speichern (einmalig)

ssh_save_server(
    alias='vps',
    host='192.168.10.1',
    username='sassogba',
    password='your-password',
    auto_connect=True  # Auto-connect on startup
)

2. Verbinden (einfacher Modus)

ssh_connect(alias='vps')  # Loads credentials from servers.json

3. Befehle ausführen

ssh_exec(alias='vps', command='df -h')
ssh_exec_sudo(alias='vps', command='systemctl restart nginx', sudo_password='...')

Neuerungen in v4.0

Modus für intelligente Verbindungen

• ssh_connect akzeptiert jetzt nur einen Alias, um Anmeldedaten automatisch zu laden

• Keine Notwendigkeit, jedes Mal Host, Benutzername und Passwort anzugeben

• Behebt Integrationsprobleme mit Claude Code

Kritische Korrekturen

• Timeout-Behandlung: Wirft jetzt TimeoutError, anstatt stillschweigend unvollständige Puffer zurückzugeben

• Ratenbegrenzung: Mindestens 100 ms zwischen Netzwerkbefehlen, um Gerätesättigung zu verhindern

• Magische Zahlen eliminiert: Benannte Konstanten für Shell-Dimensionen

Dokumentation

• Neue CLAUDE_CODE_USAGE.md mit vollständigen Anwendungsbeispielen

• Neue CLAUDE_CODE_SETUP.md für die Konfiguration

• Neue CHANGELOG.md mit vollständiger Versionshistorie

Sicherheitsmodell

servers.json enthält nur nicht sensible Metadaten. Geheimnisse liegen im Windows Credential Manager unter Zielen wie:

• ssh-mcp:<alias>:password

• ssh-mcp:<alias>:key_passphrase

Host-Key-Richtlinie

• strict: Standard, lehnt unbekannte Host-Keys ab (Produktion)

• auto_add: akzeptiert unbekannte Host-Keys (nur Labor)

Netzwerkgeräte

Unterstützte Gerätetypen:

• cisco - Cisco IOS/IOS-XE

• cisco_xr - Cisco IOS-XR

• mikrotik - MikroTik RouterOS

• fortigate - FortiGate FortiOS

• juniper - Juniper JunOS

• generic - Linux/Unix (Standard)

Beispiel: Cisco-Backup

# Save once
ssh_save_server(
    alias='cisco-core',
    host='10.0.0.1',
    username='admin',
    password='...',
    device_type='cisco',
    auto_connect=True
)

# Connect
ssh_connect(alias='cisco-core')

# Backup config
ssh_backup_config(alias='cisco-core', device_type='cisco')
# Saved to: backups/cisco-core/cisco-core_2026-05-31_14-30-00.txt

# Execute commands
ssh_exec_network(
    alias='cisco-core',
    commands=['show version', 'show ip interface brief'],
    device_type='cisco'
)

# Push config
ssh_push_config(
    alias='cisco-core',
    config='''
interface GigabitEthernet0/1
 description Uplink to Core
 ip address 10.0.1.1 255.255.255.0
 no shutdown
''',
    device_type='cisco',
    save_config=True
)

Verwendung mit Claude Code

Siehe CLAUDE_CODE_USAGE.md für detaillierte Beispiele.

TL;DR:

1. Save: ssh_save_server(alias='vps', host='192.168.10.1', username='sassogba', password='...')
2. Connect: ssh_connect(alias='vps')
3. Execute: ssh_exec(alias='vps', command='df -h')

18 verfügbare Tools

Verbindungsverwaltung

• ssh_connect - Stellt eine persistente SSH-Verbindung her (intelligenter Modus: einfach Alias angeben)

• ssh_disconnect - Schließt Verbindung und Tunnel

• ssh_list - Listet aktive Verbindungen mit Status auf

Persistente Konfiguration

• ssh_save_server - Speichert Server in servers.json (Geheimnisse im Credential Manager)

• ssh_remove_server - Entfernt gespeicherten Server

• ssh_list_servers - Listet alle gespeicherten Server auf

Linux/Unix-Ausführung

• ssh_exec - Führt Shell-Befehl aus

• ssh_exec_sudo - Führt mit sudo aus (automatische Passworteingabe)

Ausführung auf Netzwerkgeräten

• ssh_exec_network - Führt Befehle auf Netzwerkgeräten aus (verarbeitet Paginierung und Eingabeaufforderungen)

• ssh_push_config - Stellt Konfigurationsblock bereit

• ssh_backup_config - Sichert laufende Konfiguration in lokale Datei

• ssh_restore_config - Stellt Konfiguration aus Sicherungsdatei wieder her

• ssh_diff_config - Vergleicht Konfigurationen (Diff im Git-Stil)

SFTP

• ssh_upload - Lädt Datei auf entfernten Server hoch

• ssh_download - Lädt Datei von entferntem Server herunter

• ssh_list_remote - Listet Inhalte des entfernten Verzeichnisses auf

Tunnel

• ssh_tunnel - Erstellt persistenten SSH-Tunnel (Portweiterleitung)

• ssh_close_tunnel - Schließt Tunnel anhand der Bezeichnung

Architektur

• SSHPool: Thread-sicherer Verbindungspool mit automatischer Wiederverbindung

• SSHConnection: Zustand pro Verbindung mit RLock für Thread-Sicherheit

• ThreadPoolExecutor: Async/await-Wrapper für Paramiko (das synchron ist)

• Ratenbegrenzer: Mindestens 100 ms zwischen Befehlen, um Gerätesättigung zu verhindern

• Timeout-Behandlung: Mehrere Ebenen (pro Befehl, gesamt, absolut) mit korrekter Fehlerweitergabe

Anforderungen

paramiko>=3.0.0
mcp>=1.0.0
pywin32>=306

Installieren mit:

pip install -r requirements.txt

Tests ausführen

python -m pytest tests -v

Dokumentation

• CLAUDE_CODE_USAGE.md - Anwendungsbeispiele für Claude Code

• CLAUDE_CODE_SETUP.md - Konfigurationsanleitung

• CHANGELOG.md - Versionshistorie und Migrationsanleitung

Lizenz

MIT