ellmos-servercommander-mcp

Alpha MCP-Server für Serveroperationen: Deployment-Trockenläufe, Mail-Status, Zugriffslog-Analyse und HTTP-Health-Checks.

Deutsches README: README_de.md

Teil der ellmos-ai Familie.

[!NOTE] Auffindbarkeit & KI-Suche: Veröffentlicht auf npm als ellmos-servercommander-mcp, katalogisiert für MCP-Ökosysteme in server.json, glama.json und smithery.yaml, und indiziert für KI/LLM-Suche in llms.txt.

Architecture Visualized

graph TD
    Client[MCP Host: Claude / Cursor] <-->|stdio / JSON-RPC| NodeWrapper[Node.js Entrypoint]
    NodeWrapper <-->|Spawn subprocess| PyServer[Python MCP Server]
    
    subgraph Tools [ServerCommander Tools]
        PyServer -->|sc_health_check| HTTP[HTTP/HTTPS Endpoint Check]
        PyServer -->|sc_logs_analyze| Logs[Apache/Nginx Access Logs]
        PyServer -->|sc_deploy / sc_deploy_status| Deploy[Dry-Run Manifest & SQLite History]
        PyServer -->|sc_mail_*| Mail[IMAP/SMTP Safe Readiness Diagnostics]
    end
    
    subgraph Storage [Local Storage]
        Deploy -->|Optional persist| SQLite[(SQLite Deploy History)]
        Logs -->|Optional persist| JSONReports[(JSON Log Reports)]
    end

Related MCP server: automation-health-mcp

Start Here

Status

• Transport: stdio über das Python MCP SDK

• Paketstatus: öffentliches Alpha-Paket unter ellmos-ai

• Aktueller Kern: MCP-Tool-Auflistung, MCP-Tool-Dispatch, Konfigurationsladen, HTTP-Health-Checks, erweiterte Zugriffslog-Analyse mit optionalen persistierten JSON-Berichten und optionaler lokaler Dry-Run-Deployment-Verlauf

• Sichere Alpha-Handler: sc_deploy erstellt lokale SHA256-Manifeste, Konfigurationsdiagnostik und opt-in SQLite-Verlaufsaufzeichnungen im Dry-Run-Modus; sc_mail_* meldet protokollspezifische IMAP/SMTP-Bereitschaft ohne Öffnen von Mail-Verbindungen

• i18n: lokalisierte MCP-Tool-Beschreibungen, Eingabeschema-Feldbeschreibungen und Unbekanntes-Tool-Fehler für en, de, es, zh, ja, ru mit englischem Fallback

Install

Das npm-Paket enthält einen Node-Wrapper, der den Python-Server startet. Sie benötigen weiterhin Python 3.10+ und das Python-Paket mcp>=1.0.0.

Option 1: Install From npm

npm install -g ellmos-servercommander-mcp@alpha
ellmos-servercommander

Option 2: Install From Source

git clone https://github.com/ellmos-ai/ellmos-servercommander-mcp.git
cd ellmos-servercommander-mcp
$env:PYTHONIOENCODING = "utf-8"
python -m pip install -e ".[dev]"
python -m pytest -q

Vermeiden Sie es, ein .venv in cloud-synchronisierten Ordnern zu erstellen, wenn Ihr Sync-Client Dateien sperrt. Wenn Sie eine isolierte Umgebung benötigen, erstellen Sie sie außerhalb dieses Ordners.

Start From Source

$env:PYTHONPATH = "src"
python -m servercommander.server

MCP Client Configuration

{
  "mcpServers": {
    "servercommander": {
      "command": "ellmos-servercommander"
    }
  }
}

{
  "mcpServers": {
    "servercommander": {
      "command": "npx",
      "args": ["-y", "ellmos-servercommander-mcp@alpha"]
    }
  }
}

{
  "mcpServers": {
    "servercommander": {
      "command": "python",
      "args": ["-m", "servercommander.server"],
      "env": {
        "PYTHONPATH": "C:/path/to/ellmos-servercommander-mcp/src",
        "SERVERCOMMANDER_CONFIG_PATH": "C:/path/to/config/servercommander.toml"
      }
    }
  }
}

Configuration

ServerCommander sucht nach Konfiguration in dieser Reihenfolge:

1. Umgebungsvariable SERVERCOMMANDER_CONFIG_PATH

2. ./servercommander.toml

3. ./config/servercommander.toml

4. ~/.config/servercommander/servercommander.toml

Eine kommentierte Vorlage ist unter config/servercommander.example.toml enthalten.

[server]
name = "servercommander"
log_level = "INFO"
language = "en"

[deploy.profiles.staging]
target = "sftp://staging.example.com/var/www/app"
local_path = "./dist"
protocol = "sftp"
dry_run = true
record_history = true

[mail]
execution_enabled = false
smtp_host = "smtp.example.com"
smtp_port = 587
imap_host = "imap.example.com"
imap_port = 993

Geheimnisse sollten über Umgebungsvariablen referenziert werden, z.B. $MAIL_PASSWORD oder $SFTP_PASSWORD.

Tools

• sc_health_check: überprüft HTTP-Endpunkte und meldet Statuscode plus Latenz; fehlerhafte Endpunkt-URLs werden als fehlgeschlagene Prüfungen zurückgegeben, sodass eine schlechte Eingabe einen Batch nicht abbricht

• sc_logs_analyze: analysiert Apache/Nginx-Zugriffslogs aus Inline-Text oder einer lokalen Datei, einschließlich Statusklassen, Bytes, Referer, Fehlerpfade, verdächtige Anfragemarkierungen und optionaler JSON-Berichtspersistenz über persist_report

• sc_deploy: erstellt einen Deployment-Plan mit einem lokalen SHA256-Manifest und Profildiagnostik, lädt aber noch nicht hoch; Bereitschaftsprüfungen erfordern Pflichtfelder, manifestierbare lokale Pfade und unterstützte Protokolle vor optionalem record_history=true; verschachtelte Symlinks werden gemeldet, aber ausgeschlossen, sodass ein Manifest nicht stillschweigend über das ausgewählte Release-Verzeichnis hinausgehen kann

• sc_deploy_status: zeigt konfigurierte Deploy-Profile, ausgewählte Profildiagnostik und aktuellen Dry-Run-Verlauf aus der lokalen SQLite-Verlaufsdatenbank

• sc_mail_list, sc_mail_read, sc_mail_send, sc_mail_search: sichere Alpha-Statusantworten mit aktionsspezifischer IMAP/SMTP-Bereitschaftsdiagnostik und standardmäßig keinen Mail-Verbindungen. Mit [mail].execution_enabled = true führt sc_mail_list eine Live-, schreibgeschützte IMAP-Erreichbarkeitssonde durch (verbinden + Ordner auflisten), indem das kanonische mail-connector-Modul wiederverwendet wird – es implementiert keinen IMAP-Client neu; Nachrichtenebene lesen/suchen bleibt Domäne von mail-connector, und SMTP-Senden bleibt nicht ausführend

Search And Disambiguation

ServerCommander ist der ellmos-Operations-MCP-Server für lokale Serververwaltungs-Workflows. Verwenden Sie dieses Repository, wenn Sie nach Folgendem suchen:

• MCP-Server-Operations-Tools

• MCP-Deploy-Dry-Run-Server

• MCP-Zugriffslog-Analyzer

• MCP-HTTP-Health-Check-Tool

• Lokale Serververwaltung MCP

• Claude Code Server Operations MCP

• Sicheres SFTP-Deployment-Planungs-MCP

Es ist nicht der GitHub MCP-Server, kein generischer Shell-Befehl-MCP-Server, kein Hosting-Provider-Kontrollpanel und noch kein Produktions-SFTP/IMAP-Ausführer. Die aktuelle Alpha-Oberfläche ist absichtlich diagnostisch und zuerst trockenlaufend.

ellmos-ai Ecosystem

Dieser MCP-Server ist Teil des ellmos-ai-Ökosystems – KI-Infrastruktur, MCP-Server und intelligente Werkzeuge.

MCP Server Family

AI Infrastructure & Developer Tools

Desktop-Software

Unsere Partnerorganisation open-bricks bündelt KI-native Desktop-Anwendungen – eine moderne Open-Source-Softwaresuite für das Zeitalter der KI. Zu den Kategorien gehören Dateiverwaltung (ProFiler), Dokumentenwerkzeuge (DokuZen, PDFtoPDFocr), Entwicklerwerkzeuge (DevCenter, CodeBox) und mehr.

Entwicklung

$env:PYTHONIOENCODING = "utf-8"
python -m pytest -q
npm run smoke
npm pack --dry-run

Nächster sinnvoller Schritt: explizit konfigurierte Ausführungsadapter für SFTP und IMAP/SMTP hinzufügen, während die Dry-Run-/Status-Only-Standardwerte erhalten bleiben.