SSH MCP Server

Lass KI-Clients sicher auf deinem Server arbeiten – ein SSH-basierter MCP-Server

Führe Befehle auf entfernten Systemen aus und übertrage Dateien über standardisierte MCP-Tools – mit integrierter Weboberfläche und Windows-Tray-App.

Was es kann

Verbinde KI-Clients, die das MCP-Protokoll unterstützen (z. B. Claude Code, Cursor), mit deinem SSH-Server – die KI kann dann:

• ⚙️ Befehle ausführen – Remote-Administration, Log-Analyse, Diensteverwaltung

• 📤 Dateien hochladen / 📥 herunterladen – Konfigurationsverteilung, Log-Abruf, unterbrechbare Fortsetzung großer Dateien

• 🖥️ Mehrere Maschinen verwalten – Drei-Ebenen-Struktur Projekt → Umgebung → Host, einmal konfiguriert und überall nutzbar

Zwei Einsatzformen, je nach Bedarf:

Related MCP server: sshops

✨ Kernfunktionen

Verbindungsmöglichkeiten

• 🔐 Mehrere Authentifizierungsarten: Passwort / privater Schlüssel (auch verschlüsselt) / SSH Agent / interaktive Tastatur- 2FA

• 🔗 SOCKS5- und HTTP(S)-Proxy zur Überbrückung von Sprungbrett-Netzwerken

• 🚄 Zwei Übertragungsmodi:

  • exec – ein Kanal pro Befehl, für Standard-Linux-Hosts

  • shell – persistente Sitzung + Marker-Protokoll, geeignet für Bastion-Hosts / Jump-Hosts

• ⏱️ Verbindungs-, Befehls- und SFTP-Zeitlimits unabhängig voneinander einstellbar; große Dateien nutzen fastPut/fastGet mit fragmentierter Parallelübertragung

Sicherheitsrichtlinien

• Befehls-Whitelist / Blacklist (Regex), zweistufige Filterung auf Host- und globaler Ebene

• Whitelist für lokale und entfernte Pfade, begrenzt den Bereich für Dateiübertragungen

• Vollständige Audit-Logs: Befehle, Ausgaben, Übertragungsaufzeichnungen nachvollziehbar

Weboberfläche

• Sichtbare Drei-Ebenen-Verwaltung Projekt-Umgebung-Host, Verbindungen per Drag & Drop sortieren

• Verbindung testen, JSON-Stapel-Import/-Export, automatische Wiederverwendung von ~/.ssh/config

• Geplante Sicherungs-Snapshots und Wiederherstellung mit einem Klick; Ein-Klick-Registrierung von MCP-Clients (z. B. Claude Code)

• Hell- und Dunkelthema, wechselt automatisch mit dem System

Windows-Desktop-App

• 🎯 Reines Tray-Einzel-exe: SSH-Dienst, MCP Server und Admin-Statikseite komplett integriert, ohne Node.js-Abhängigkeit

• Autostart beim Hochfahren, bleibt beim Herunterfahren aktiv; „Verwaltungsseite öffnen" führt direkt zum Standardbrowser des Systems

• 🔄 Online-Self-Update: Integrierte minisign-Signaturprüfung, erkennt automatisch neue Versionen und aktualisiert im Hintergrund

📸 Benutzeroberfläche im Überblick

Verbindungsverwaltung – Drei-Ebenen-Struktur verwaltet alle Hosts:

Systemseite – Dienststatus und Ein-Klick-Registrierung von MCP-Clients:

🚀 Schnellstart

Weg 1: Windows-Desktop-App

Lade von Releases die SSH-MCP-Server_x.x.x_x64-setup.exe herunter und installiere sie. Nach dem Start bleibt sie im System-Tray; über das Tray-Menü „Verwaltungsseite öffnen" gelangst du in die Weboberfläche.

Bereits installierte Nutzer erhalten Updates automatisch, ohne manuelles Eingreifen.

Weg 2: npm-Paket (stdio MCP Server)

# 全局安装
npm install -g @sieop/ssh-mcp-server

Registriere den Server in deinem MCP-Client (am Beispiel Claude Code):

claude mcp add ssh-server -- ssh-mcp-server --host your.server.com --username root --password YOUR_PWD

Oder schreibe direkt eine JSON-Konfiguration:

{
  "mcpServers": {
    "ssh-server": {
      "command": "npx",
      "args": ["-y", "@sieop/ssh-mcp-server", "--host", "your.server.com", "--username", "root", "--password", "YOUR_PWD"]
    }
  }
}

Konfigurationsdateien und der Multi-Verbindungsmodus werden ebenfalls unterstützt – weitere Details findest du in docs/migration.md und in der CLI-Hilfe (--help).

Weg 3: Aus dem Quellcode erstellen

git clone https://github.com/SIE-Operations-and-Maintenance-Team/ssh-mcp-server.git
cd ssh-mcp-server && npm install

npm run build                 # 构建 Node 版
npm test                      # 运行测试
npm --prefix admin-web install && npm --prefix admin-web run build   # 构建管理台前端
npm run tauri:build           # 构建 Windows 桌面应用（需 Rust 工具链）

🧰 MCP-Tools im Überblick

🏗️ Architektur

┌─ Windows 桌面应用（Tauri 2 纯托盘单 exe）──────────────────┐
│                                                            │
│  SSH 连接池 ── MCP StreamableHTTP (/mcp)                   │
│      │                                                     │
│  Admin API (/admin/api/*) ── 内嵌静态站点 (/admin/)        │
│                                                            │
└────────────────── 系统默认浏览器打开管理页 ────────────────┘

Node 版（npm 包）：stdio MCP Server ＋ 可选 --admin 启动同一套 Web 管理台

Wichtige Module: src/services/ssh-connection-manager.ts (SSH-Kern), src/server/ (Fastify-Admin-Dienst), src-tauri/ (Rust-Desktop-Shell), admin-web/ (React-Verwaltungsoberfläche).

📋 Weitere Dokumentation

• Migrations- und Nutzungsleitfaden – Einrichtung für verschiedene Clients

• Änderungsprotokoll

📄 Lizenz

ISC © SIE Operations and Maintenance Team

Dieses Projekt stammt von classfang/ssh-mcp-server und wurde auf dessen Grundlage überarbeitet und erweitert.