@yawlabs/ssh-mcp

SSH-Operationen für KI-Agenten. MCP-Server mit Remote-Befehlsausführung, Dateiübertragung und integrierter SSH-Diagnose, die Ihnen genau sagt, was falsch ist und wie es behoben werden kann.

Erstellt und gewartet von Yaw Labs.

Warum dieses Tool?

KI-Agenten, die sich per SSH auf Remote-Server verbinden, stoßen immer wieder auf dieselben Probleme: inaktiver ssh-agent, falscher Schlüssel geladen, veraltete Host-Keys von neu erstellten Instanzen, "Permission denied" ohne hilfreichen Kontext. Die meisten SSH-MCP-Server kapseln nur ssh2 und lassen den Agenten mit kryptischen Fehlern allein.

Dieser Server enthält ssh_diagnose – ein Diagnosetool, das Ihre gesamte SSH-Umgebung (Agent, Schlüssel, Konfiguration, known_hosts, Konnektivität) überprüft und umsetzbare Befehle zur Fehlerbehebung zurückgibt. Verwenden Sie es vor dem Verbindungsaufbau oder nach einem Fehler.

Schnellstart

npm install -g @yawlabs/ssh-mcp

Fügen Sie dies zu Ihrer MCP-Client-Konfiguration hinzu:

{
  "mcpServers": {
    "ssh": {
      "command": "ssh-mcp"
    }
  }
}

Tools

Kernoperationen

Diagnose

Authentifizierung

Alle Tools akzeptieren Verbindungsparameter:

Reihenfolge der Authentifizierungsauflösung: expliziter Schlüssel > explizites Passwort > ssh-agent (SSH_AUTH_SOCK) > Standard-Schlüsselpfade (~/.ssh/id_ed25519, id_rsa, id_ecdsa).

Diagnose

ssh_diagnose führt 5 Prüfungen durch und gibt einen strukturierten Bericht zurück:

1. SSH Agent — Läuft ssh-agent? Sind Schlüssel geladen?

2. SSH Keys — Existieren private Schlüssel in ~/.ssh/?

3. SSH Config — Gibt es einen Konfigurationseintrag für diesen Host? (unterstützt Platzhalter)

4. Known Hosts — Ist der Host-Key zwischengespeichert?

5. Connectivity — Können wir tatsächlich eine Verbindung herstellen?

Jede fehlgeschlagene Prüfung enthält den genauen Befehl zur Behebung. Beispielausgabe:

SSH Diagnostic Report for dev-server:22
Overall: ERROR

[PASS] SSH Agent
  ssh-agent running with keys:
  256 SHA256:abc... user@host (ED25519)

[PASS] SSH Keys
  Found SSH keys: id_ed25519, gh_woods

[PASS] SSH Config
  SSH config for "dev-server":
  Host dev-server
    HostName 10.0.1.50
    User ec2-user

[FAIL] Known Hosts
  Host "dev-server" is not in known_hosts.

[FAIL] Connectivity
  Host key verification failed for dev-server. The host key changed (instance recreated?).

Suggested fixes:
  - Remove stale host key: ssh-keygen -R "dev-server"
  - Re-add host key: ssh-keyscan -H "dev-server" >> ~/.ssh/known_hosts

Programmatische Verwendung

import { connect, exec, diagnose } from '@yawlabs/ssh-mcp';

// Run a command
const client = await connect({ host: 'my-server', username: 'deploy' });
const result = await exec(client, 'uptime');
console.log(result.stdout);
client.end();

// Diagnose connectivity issues
const report = diagnose('my-server');
console.log(report.overall); // "ok" | "warning" | "error"
for (const check of report.checks) {
  console.log(`[${check.status}] ${check.name}: ${check.message}`);
}

Anforderungen

• Node.js 18+

• Installierter SSH-Client (für Diagnosen)

Lizenz

MIT