Claude systemd

Schreibgeschützte systemd-Inspektion für Claude Desktop unter Linux. Ermöglicht es Claude, die häufigste Linux-Betriebsfrage zu beantworten – „Warum ist dieser Dienst defekt?“ – ohne dass Sie die Ausgaben von systemctl und journalctl manuell kopieren und einfügen müssen.

Sieben Tools decken das Auflisten von Einheiten, den Status pro Einheit, das Auslesen des Journals, die Suche nach fehlerhaften Einheiten, die Inspektion von Einheiteneigenschaften, die Anzeige von Roh-Einheitsdateien (einschließlich Drop-in-Overrides) und die Inspektion von wartenden Jobs ab.

In v0.1 strikt schreibgeschützt. Kein restart, enable, disable oder daemon-reload. Sicher auf Produktions-Hosts und gemeinsam genutzten Systemen zu aktivieren. Wenn Sie destruktive Kontrolle benötigen, führen Sie diese Befehle manuell über claude-terminal-mcp aus.

Anforderungen

• Linux mit systemd (jedes moderne Ubuntu/Debian/Fedora/Arch).

• systemctl und journalctl im PATH (Standard bei systemd).

• Lesezugriff auf das Journal für die Einheiten, die Sie interessieren. Standardmäßig erfordert der systemweite Journalzugriff die Mitgliedschaft in der Gruppe systemd-journal oder adm; Benutzer-Journale sind immer für ihren Besitzer lesbar.

Related MCP server: systemd-mcp

Installation (Claude Desktop)

1. Laden Sie die neueste Systemd.mcpb von der Releases-Seite herunter.

2. Einstellungen → Erweiterungen → Erweiterungsentwickler → Erweiterung installieren → wählen Sie die .mcpb aus.

3. Aktivieren.

Tools

Alle Tools unterstützen scope: "user", um --user-Einheiten zu inspizieren. Der Standard-Scope ist system.

Beispiel-Prompts

„Ist gerade irgendetwas im fehlerhaften Zustand?“ → failed_units

„Warum nutzt ollama.service die GPU nicht? Zeig mir die Drop-in-Overrides und die letzten 50 Log-Zeilen.“ → unit_cat ollama dann tail_journal unit=ollama lines=50

„Was sagt das Journal über Fehler und Schlimmeres in den letzten 10 Minuten?“ → tail_journal priority=3 since="10 minutes ago"

„Ist nginx beim Booten aktiviert und wie oft wurde es seit dem letzten Booten neu gestartet?“ → unit_status nginx

Datenschutzrichtlinie

Diese Erweiterung läuft vollständig auf Ihrem lokalen Computer und greift nur auf systemctl und journalctl zu. Es verlassen keine Daten Ihren Computer. Kein Netzwerk-I/O. Schreibgeschützt – kann nichts ändern, neu starten, aktivieren, deaktivieren oder neu laden.

Die für Claude sichtbaren Informationen umfassen:

• Namen, Beschreibungen und Metadaten jeder System- oder Benutzereinheit, die Sie abfragen (oder jede geladene Einheit, wenn Sie list_units aufrufen).

• Der vollständige Inhalt von Einheitsdateien und Drop-in-Overrides (unit_cat) – diese können Environment=-Zeilen mit Geheimnissen enthalten, falls Sie diese dort festgelegt haben. Speichern Sie keine Anmeldedaten in Einheitsdateien, wenn Sie diese Erweiterung aktivieren möchten.

• Aktuelle Journal-Einträge für abgefragte Einheiten – einschließlich aller Nachrichten, die Dienste protokollieren, welche personenbezogene Daten, IP-Adressen, Anforderungspfade oder Stack-Traces enthalten können.

• Prozess-IDs, Neustart-Anzahlen und Laufzeiteigenschaften von Diensten.

Wenn Ihre Einheitsdateien oder Journale sensible Daten enthalten und Sie dem LLM-Endpunkt nicht vertrauen, aktivieren Sie diese Erweiterung nicht.

Warum keine destruktiven Operationen?

Ein restart_unit / enable_unit / disable_unit-Set wurde in v0.1 bewusst weggelassen, weil:

1. Sie Root-Rechte für System-Einheiten erfordern, was bedeutet, entweder Claude Desktop als Root auszuführen (schlecht) oder sudo-Regeln zu konfigurieren (erweiterungsspezifischer Aufwand).

2. Sie in dem Workflow, den diese Erweiterung tatsächlich bedient, selten benötigt werden – „Warum ist X defekt“ ist der 95%-Fall.

3. Wenn Sie einen Dienst neu starten müssen, bietet das vorhandene claude-terminal-mcp Ihnen run_command sudo systemctl restart <unit> mit denselben sudo-Mechanismen, die Sie überall sonst verwenden würden, plus einen Bestätigungsschritt an der System-Eingabeaufforderung.

Die Beibehaltung des Schreibschutzes dieser Erweiterung bedeutet, dass sie auf einem Produktions-Host, einer gemeinsam genutzten Workstation oder einer Kundenmaschine ohne Vertrauensbedenken aktiviert werden kann. v0.2 könnte dies überdenken.

Fehlerbehebung

„systemctl is not installed“ – Dieser Server ist nur für Linux. macOS und Windows führen kein systemd aus.

„Permission denied“ beim Lesen des Journals – Fügen Sie sich selbst zu systemd-journal oder adm hinzu: sudo usermod -aG systemd-journal $USER und melden Sie sich dann ab und wieder an. Oder rufen Sie es mit scope: "user" auf, um nur Ihr eigenes Benutzer-Journal zu lesen (keine Gruppe erforderlich).

Leere tail_journal-Ergebnisse – Einige Distributionen haben ratenbegrenzte oder flüchtige Journale. Überprüfen Sie Storage= in /etc/systemd/journald.conf – volatile bedeutet, dass das Journal beim Neustart gelöscht wird.

Entwicklung

Einzelnes ~400-zeiliges Node.js-Skript, null npm-Abhängigkeiten. Bauen Sie die .mcpb neu:

cd bundle-source
zip -j ../Systemd.mcpb manifest.json package.json server.js README.md LICENSE icon.png glama.json

Lizenz

MIT. Siehe LICENSE.

Verwandtes

• claude-terminal-mcp – Shell + Dateisystem + Hintergrund-Jobs (verwenden Sie dies für destruktive systemctl-Aktionen).

• claude-sessions-mcp – tmux-Sitzungsverwaltung für lang laufende Jobs.

• claude-rocm-mcp – AMD GPU-Überwachung; passt gut zu „Ist die GPU gesund?“ neben „Ist der GPU-Dienst gesund?“

• claude-linux-mcp – X11-Desktop-Steuerung.

• claude-ollama-mcp – lokaler Ollama HTTP-API-Client.