MCP SSH Manager - SSH Remote-Serververwaltung über das Model Context Protocol 🚀

Ein Model Context Protocol (MCP) Server, der es Claude Code und OpenAI Codex ermöglicht, mehrere SSH-Verbindungen zu verwalten. Führen Sie Befehle aus, übertragen Sie Dateien, verwalten Sie Datenbanken, erstellen Sie Backups, überwachen Sie den Systemzustand und automatisieren Sie DevOps-Aufgaben auf Ihren Servern — direkt von Ihrem KI-Assistenten aus.

🎉 Was ist neu in v3.2.2

Korrektur der globalen Installation & CLI-Binary (Veröffentlicht: 7. April 2026)

🔧 Globale Installation korrigiert: Die .env-Pfadauflösung verwendet jetzt eine Fallback-Kette anstelle von hartkodiertem __dirname — funktioniert korrekt mit npm install -g (#16, #19)
- Fallback-Kette: ~/.ssh-manager/.env → cwd/.env → ~/.env → Projekt .env
- Erstellt automatisch ~/.ssh-manager/.env beim ersten ssh-manager server add
📦 ssh-manager CLI als Binary registriert: npm install -g erstellt jetzt sowohl mcp-ssh-manager als auch ssh-manager Befehle (#18)
⚡ Race-Condition-Fix: Die Serverkonfiguration wird jetzt vollständig geladen, bevor der MCP-Server Anfragen akzeptiert

Related MCP server: MCP Server for FTP Access

Frühere Versionen

v3.2.0 - ProxyJump / Bastion Host Unterstützung (18. März 2026)

🔀 ProxyJump-Unterstützung: Verbinden Sie sich mit Servern hinter Bastion-/Jump-Hosts mit einem einfachen PROXYJUMP-Konfigurationsfeld (#15)
- Verketten Sie mehrere Sprünge (A → B → C) über rekursive Verbindungen
- Erkennung zirkulärer Abhängigkeiten verhindert Endlosschleifen
- Alle Tools funktionieren transparent über Jump-Hosts
📦 npx-Unterstützung korrigiert: npx mcp-ssh-manager funktioniert jetzt korrekt (#14)

v3.1.5 - SSH-Agent & Passphrase-Unterstützung (5. März 2026)

🔑 SSH-Agent-Unterstützung: Verwendet automatisch ssh-agent, wenn SSH_AUTH_SOCK verfügbar ist — passwortgeschützte Schlüssel funktionieren transparent
🔐 Passphrase-Konfiguration: Neues passphrase-Feld für .env und TOML-Formate

Dank an @snjax für den ursprünglichen Beitrag (#12).

v3.1.4 - Windows SSH-Host-Unterstützung (22. Februar 2026)

🪟 Windows SSH-Host-Fix: Befehle schlagen auf Windows-Hosts mit OpenSSH nicht mehr fehl (#10)
Neues platform-Konfigurationsfeld pro Server (SSH_SERVER_FOO_PLATFORM=windows oder platform = "windows" in TOML)
Wenn platform=windows, wird der Linux-Wrapper timeout/sh -c übersprungen und stattdessen das native Timeout der SSH-Bibliothek verwendet
Alle Tools (ssh_execute, ssh_tail, ssh_monitor, ssh_deploy, ssh_execute_sudo, ssh_group_execute) sind plattformbewusst

v3.1.2 - Windows-Kompatibilitätsfix (9. Februar 2026)

🪟 Windows-Unterstützung: Absturz unter Windows behoben, bei dem process.env.HOME undefiniert war (#8)
Verwendet jetzt os.homedir() für plattformübergreifende Kompatibilität (Linux, macOS, Windows)

v3.1.0 - Tool-Aktivierungssystem (15. November 2025)

🎯 Optimierung der Kontextnutzung

92% Kontextreduzierung: Aktivieren Sie nur die Tools, die Sie benötigen (Minimalmodus: 5 Tools statt alle 37)
Tool-Management-CLI: ssh-manager tools list/configure/enable/disable
6 Tool-Gruppen: Core, Sessions, Monitoring, Backup, Database, Advanced
Auto-Approval-Export: Generieren Sie Konfigurationen für die automatische Genehmigung in Claude Code

v3.0.0 - Enterprise DevOps-Plattform (1. Oktober 2025)

Diese Version fügt 12 neue MCP-Tools hinzu, die den SSH Manager in eine umfassende DevOps-Automatisierungsplattform verwandeln:

💾 Backup & Restore-System (4 Tools)

Automatisierte Backups für MySQL, PostgreSQL, MongoDB und Dateisysteme
Intelligente Zeitplanung mit Cron-Integration und Aufbewahrungsrichtlinien
Ein-Klick-Wiederherstellung mit datenbankübergreifender Unterstützung
Metadaten-Tracking für Audit und Compliance

🏥 Systemzustand & Monitoring (4 Tools)

Echtzeit-Zustandsprüfungen mit CPU-, RAM-, Festplatten- und Netzwerkmetriken
Service-Monitoring für Nginx, MySQL, Docker und benutzerdefinierte Dienste
Prozessverwaltung mit Sortierung nach CPU/RAM und Beendigungsfunktionen
Warnschwellen mit konfigurierbaren Benachrichtigungen

🗄️ Datenbankverwaltung (4 Tools)

Sichere Datenbank-Dumps mit Komprimierung und selektiven Exporten
Datenbankimporte mit automatischer Dekomprimierung
Schema-Erkundung zur Auflistung von Datenbanken, Tabellen und Sammlungen
Sichere Abfragen mit SQL-Injection-Prävention (nur SELECT)

📊 Gesamt: 37 MCP-Tools | 🔧 ~4.100 Zeilen Code hinzugefügt | ✅ Produktionsbereit

Vollständiges Changelog lesen →

📑 Inhaltsverzeichnis

🌟 Funktionen

Kernfunktionen

🔗 Mehrere SSH-Verbindungen - Verwalten Sie unbegrenzt viele SSH-Server über eine einzige Schnittstelle
🔐 Sichere Authentifizierung - Unterstützung für Passwort-, SSH-Schlüssel- und SSH-Agent-Authentifizierung (einschließlich passwortgeschützter Schlüssel)
🔀 ProxyJump / Bastion Host - Verbinden Sie sich mit Servern hinter Jump-Hosts mit verketteter Multi-Hop-Unterstützung
📁 Dateioperationen - Hoch- und Herunterladen von Dateien zwischen lokalen und Remote-Systemen
⚡ Befehlsausführung - Führen Sie Befehle auf Remote-Servern mit Unterstützung für Arbeitsverzeichnisse aus
📂 Standardverzeichnisse - Legen Sie bequeme Standard-Arbeitsverzeichnisse pro Server fest
🎯 Einfache Konfiguration - Einfache .env-Dateieinrichtung mit geführtem Konfigurationstool

Enterprise DevOps-Funktionen (v3.0) 🎉

💾 Backup & Restore - Automatisierte Backups für MySQL, PostgreSQL, MongoDB und Dateien
🏥 Monitoring des Systemzustands - Echtzeit-Zustandsprüfungen (CPU, RAM, Festplatte, Dienste)
🗄️ Datenbankverwaltung - Sichere Datenbankoperationen mit SQL-Injection-Prävention
📊 Prozessverwaltung - Überwachen und steuern Sie Serverprozesse
⚠️ Intelligente Warnungen - Konfigurierbare Schwellenwerte und Benachrichtigungen

v2.0 Funktionen

🚀 Bash CLI - Blitzschnelle, reine Bash-CLI für die Serververwaltung
📊 Erweitertes Logging - Umfassendes Protokollierungssystem mit Ebenen und Historie
🔄 Rsync-Integration - Bidirektionale Dateisynchronisierung mit rsync-Unterstützung
💻 Persistente Sitzungen - Behalten Sie den Shell-Kontext über mehrere Befehle hinweg bei
👥 Servergruppen - Führen Sie Befehle gleichzeitig auf mehreren Servern aus
🔧 SSH-Tunnel - Lokale/Remote-Portweiterleitung und SOCKS-Proxy-Unterstützung
📈 Systemüberwachung - Echtzeit-Überwachung von CPU, Speicher, Festplatte und Netzwerk
🏷️ Server-Aliase - Verwenden Sie kurze Aliase anstelle vollständiger Servernamen
🚀 Intelligente Bereitstellung - Automatisierte Dateibereitstellung mit Berechtigungsverwaltung
🔑 Sudo-Unterstützung - Führen Sie Befehle sicher mit sudo-Rechten aus
📝 OpenAI Codex-Unterstützung - Kompatibel mit OpenAI Codex über TOML-Konfiguration

⚙️ Tool-Management & Kontextoptimierung

NEU in v3.1: Reduzieren Sie die Kontextnutzung von Claude Code um 92% mit der Tool-Aktivierungsverwaltung!

MCP SSH Manager enthält 37 Tools, die in 6 Gruppen organisiert sind. Standardmäßig sind alle Tools aktiviert, aber Sie können sie für Ihren spezifischen Arbeitsablauf optimieren:

Schnelleinrichtung

# Interactive configuration wizard
ssh-manager tools configure

# View current configuration
ssh-manager tools list

# Enable/disable specific groups
ssh-manager tools enable monitoring
ssh-manager tools disable backup

Konfigurationsmodi

Modus	Tools	Kontextnutzung	Am besten für
Alle (Standard)	37 Tools	~43.5k Token	Voller Funktionsumfang, die meisten Benutzer
Minimal	5 Tools	~3.5k Token	Nur grundlegende SSH-Operationen
Benutzerdefiniert	5-37 Tools	Variiert	Auf Ihren Arbeitsablauf zugeschnitten

Tool-Gruppen

Core (5 Tools) - Immer aktiviert: list, execute, upload, download, sync
Sessions (4 Tools) - Persistente SSH-Sitzungen
Monitoring (6 Tools) - Zustandsprüfungen, Servicestatus, Prozessverwaltung
Backup (4 Tools) - Datenbank- und Dateibackups
Database (4 Tools) - MySQL, PostgreSQL, MongoDB-Operationen
Advanced (14 Tools) - Bereitstellung, sudo, Tunnel, Gruppen, Aliase usw.

Vorteile

92% Kontextreduzierung im Minimalmodus (~40k Token gespart)
Weniger Genehmigungsaufforderungen in Claude Code
Schnelleres Laden und sauberere Schnittstelle
Export der Auto-Approval-Konfiguration für Claude Code

📖 Vollständiger Leitfaden zum Tool-Management →

📋 Voraussetzungen

Node.js (v18 oder höher)
npm (wird mit Node.js geliefert)
Plattformen: Linux, macOS, Windows
Für Claude Code: Claude Code CLI installiert
Für OpenAI Codex: Codex CLI konfiguriert
Bash 4.0+ (für CLI-Management-Tools)
rsync (für Dateisynchronisierung)
sshpass (optional, für rsync mit Passwortauthentifizierung)
- macOS: brew install hudochenkov/sshpass/sshpass
- Linux: apt-get install sshpass

🚀 Schnellstart - Claude Code

1. MCP SSH Manager installieren

Option A: Von npm installieren (empfohlen)

# Install globally from npm
npm install -g mcp-ssh-manager

# Or install locally
npx mcp-ssh-manager

Option B: Aus dem Quellcode installieren

# Clone and install
git clone https://github.com/bvisible/mcp-ssh-manager.git
cd mcp-ssh-manager
npm install

# Install the Bash CLI
cd cli && ./install.sh

# Configure your first server
ssh-manager server add

2. In Claude Code installieren

# For personal use (current user only)
claude mcp add ssh-manager node /path/to/mcp-ssh-manager/src/index.js

# For team sharing (creates .mcp.json in project)
claude mcp add ssh-manager --scope project node /path/to/mcp-ssh-manager/src/index.js

# For all your projects
claude mcp add ssh-manager --scope user node /path/to/mcp-ssh-manager/src/index.js

3. Auto-Approval konfigurieren (Optional, aber empfohlen)

Um zu vermeiden, dass Sie bei jedem SSH-Befehl zur Genehmigung aufgefordert werden, fügen Sie eine Auto-Approve-Konfiguration hinzu:

Bearbeiten Sie ~/.config/claude-code/claude_code_config.json:

{
  "mcpServers": {
    "ssh-manager": {
      "command": "node",
      "args": ["/path/to/mcp-ssh-manager/src/index.js"],
      "autoApprove": [
        "mcp__ssh-manager__ssh_execute",
        "mcp__ssh-manager__ssh_list_servers",
        "mcp__ssh-manager__ssh_upload",
        "mcp__ssh-manager__ssh_download",
        "mcp__ssh-manager__ssh_sync",
        "mcp__ssh-manager__ssh_alias"
      ]
    }
  }
}

Wichtig: Starten Sie Claude Code nach dieser Änderung neu.

Für eine vollständige automatische Genehmigung aller SSH-Tools, siehe die vollständige Liste in examples/claude-code-config.example.json.

4. Loslegen!

In Claude Code können Sie jetzt:

"List all my SSH servers"
"Execute 'ls -la' on production server"  # Uses default directory if set
"Run 'docker ps' on staging"
"Upload config.json to production:/etc/app/config.json"
"Download logs from staging:/var/log/app.log"

Mit Standardverzeichnissen: Wenn Sie /var/www/html als Standard für die Produktion festlegen, sind diese Befehle äquivalent:

"Run 'ls' on production" → wird in /var/www/html ausgeführt
"Run 'ls' on production in /tmp" → wird in /tmp ausgeführt (überschreibt den Standard)

MCP SSH Manager