Unraid MCP Server
Unraid MCP
GraphQL-basierter MCP-Server für Unraid. Stellt ein einheitliches unraid-Tool für Systeminspektion, Verwaltungsaufgaben, Live-Telemetrie und destruktive Aktionen bereit, die durch explizite Bestätigung geschützt sind.
Übersicht
Der Server übersetzt MCP-Tool-Aufrufe in Unraid GraphQL-Abfragen und -Mutationen über HTTP und WebSocket. Alle Operationen nutzen ein einziges unraid-Tool, das über action + subaction gesteuert wird. Live-Telemetrie verwendet WebSocket-Abonnements, die Echtzeitdaten von der Unraid-API streamen.
Related MCP server: Model Control Plane (MCP) Server
Was dieses Repository enthält
unraid_mcp/— Server, GraphQL-Client, WebSocket-Abonnements, Konfiguration und Tool-Handlerskills/unraid/— Dokumentation der Skills für den Clientdocs/— Referenzen zu Authentifizierung, destruktiven Aktionen und Veröffentlichung.claude-plugin/,.codex-plugin/,gemini-extension.json— Client-Manifestedocker-compose.yaml,Dockerfile,entrypoint.sh— Container-Bereitstellungtests/— Unit-, Sicherheits-, Schema-, HTTP-Layer- und Live-Tests
Tools
Tool-Index
Tool | Zweck |
| Einheitlicher Action/Subaction-Router für alle Operationen |
| Gibt diese Referenz als Markdown zurück |
| Vollständiger Diagnose-Dump des WebSocket-Abonnementsystems |
| Testet ein rohes GraphQL-Abonnement für Schema-/Debug-Arbeiten |
unraid — Aktionsgruppen
Alle Operationen laufen über ein Tool. Wählen Sie eine action und dann eine subaction innerhalb dieser.
system — 18 Subactions
Serverinformationen, Metriken, Netzwerk und USV.
Subaction | Beschreibung | Erforderliche Parameter |
| OS, CPU, Speicherlayout, Versionen, Maschinen-ID | — |
| Array-Status, Kapazität, Zusammenfassung des Festplattenzustands | — |
| Zugriffs-URLs, HTTP/HTTPS-Ports, LAN/WAN-IPs | — |
| Lizenztyp, Schlüsseldatei, Ablaufdatum | — |
| Vollständiger Unraid-Variablensatz (Zeitzone, Freigaben, etc.) | — |
| Live-CPU-% und Speicherauslastung | — |
| Laufende Dienste mit Name, Online-Status, Version | — |
| Name des aktuellen UI-Themes | — |
| Konfigurationsgültigkeit und Fehlerstatus | — |
| Boolesche Erreichbarkeitsprüfung | — |
| Benutzername des Eigentümers, Avatar, Profil-URL | — |
| Einheitliche Schlüssel/Wert-Karte der Einstellungen | — |
| Zusammenfassung in einem Aufruf: Hostname, Uptime, Unraid-Version, Array-Status | — |
| Alle registrierten Server mit LAN/WAN-IPs und URLs | — |
| Hersteller- und Produktinformationen des Flash-Laufwerks | — |
| Alle USV-Geräte mit Batterie- und Leistungsmetriken | — |
| Details eines einzelnen USV-Geräts |
|
| Konfiguration des USV-Daemons | — |
health — 4 Subactions
Diagnose der Verbindungs- und Systemgesundheit.
Subaction | Beschreibung | Erforderliche Parameter |
| Umfassender Gesundheitscheck: API-Latenz, Array-Status, Warnungen, Docker-Container-Zusammenfassung | — |
| Ping an die Unraid-API und Rückgabe der Latenz in ms | — |
| Status des Abonnementsystems, Fehleranzahl, Verbindungsstatus | — |
| Interaktive Einrichtung der Anmeldedaten (unterstützt MCP-Elicitation) | — |
array — 13 Subactions
Paritätsprüfungen und Array-Festplattenoperationen. Destruktive Subactions sind mit * markiert.
Subaction | Beschreibung | Erforderliche Parameter | Destruktiv |
| Aktueller Fortschritt der Paritätsprüfung, Geschwindigkeit, Fehler | — | — |
| Ergebnisse vergangener Paritätsprüfungen | — | — |
| Startet eine Paritätsprüfung |
| — |
| Pausiert eine laufende Paritätsprüfung | — | — |
| Setzt eine pausierte Paritätsprüfung fort | — | — |
| Bricht eine laufende Paritätsprüfung ab | — | — |
| Startet das Unraid-Array | — | — |
| Stoppt das Unraid-Array |
| * |
| Fügt eine Festplatte zum Array hinzu |
| — |
| Entfernt eine Festplatte aus dem Array (Array muss gestoppt sein) |
| * |
| Mountet eine Array-Festplatte |
| — |
| Unmountet eine Array-Festplatte |
| — |
| Löscht I/O-Statistiken für eine Festplatte (irreversibel) |
| * |
disk — 6 Subactions
Freigaben, physische Festplatten, Protokolldateien und Flash-Backup. Destruktive Subactions sind mit * markiert.
Subaction | Beschreibung | Erforderliche Parameter | Destruktiv |
| Alle Benutzerfreigaben mit Größe, Zuweisungseinstellungen, LUKS-Status | — | — |
| Liste der physischen Festplatten (ID, Gerät, Name) | — | — |
| Einzelne Festplatte: Seriennummer, Größe, Temperatur |
| — |
| Liste der verfügbaren Protokolldateien (Name, Pfad, Größe, geändert) | — | — |
| Liest den Inhalt einer Protokolldatei mit Zeilenbereich |
| — |
| Initiiert rclone-Backup des Flash-Laufwerks auf ein Remote |
| * |
Details zu flash_backup: Ruft die Unraid initiateFlashBackup GraphQL-Mutation auf, die einen rclone-Kopiervorgang vom Flash-Laufwerk auf ein konfiguriertes rclone-Remote auslöst. Das Ziel auf dem Remote wird überschrieben, falls es existiert. Gibt { status, jobId } zurück. Zur Wiederherstellung: Verwenden Sie rclone, um das Backup zurück auf das Flash-Laufwerk zu kopieren, oder extrahieren Sie einzelne Konfigurationsdateien. Konfigurieren Sie das rclone-Remote zuerst über rclone/create_remote.
docker — 7 Subactions
Container-Lebenszyklus und Netzwerk-Inspektion. Keine destruktiven Subactions.
Subaction | Beschreibung | Erforderliche Parameter |
| Alle Container: ID, Namen, Image, Zustand, Status, autoStart | — |
| Vollständige Container-Details: Ports, Mounts, Labels, Netzwerkeinstellungen |
|
| Startet einen Container |
|
| Stoppt einen Container |
|
| Stoppt und startet einen Container (Stopp + Start nacheinander) |
|
| Alle Docker-Netzwerke: ID, Name, Treiber, Scope | — |
| Einzelnes Netzwerk mit IPv6, Containern, Optionen, Labels |
|
Container-Identifikatoren akzeptieren die vollständige ID, ein kurzes ID-Präfix, den exakten Namen oder ein eindeutiges Namenspräfix. Mutationen (start, stop, restart) erfordern einen exakten Namen oder die vollständige ID.
vm — 9 Subactions
Lebenszyklus virtueller Maschinen. Destruktive Subactions sind mit * markiert.
Subaction | Beschreibung | Erforderliche Parameter | Destruktiv |
| Alle VMs: ID, Name, Zustand, UUID | — | — |
| Details einer einzelnen VM |
| — |
| Startet eine VM |
| — |
| Stoppt eine VM ordnungsgemäß |
| — |
| Pausiert eine laufende VM |
| — |
| Setzt eine pausierte VM fort |
| — |
| Startet eine VM neu |
| — |
| Hartes Ausschalten einer VM (Datenverlust möglich) |
| * |
| Hartes Zurücksetzen einer VM ohne ordnungsgemäßes Herunterfahren |
| * |
vm_id akzeptiert UUID, präfixierte ID oder VM-Namen.
notification — 12 Subactions
CRUD für Systembenachrichtigungen. Destruktive Subactions sind mit * markiert.
Subaction | Beschreibung | Erforderliche Parameter | Destruktiv |
| Anzahl der ungelesenen und archivierten Benachrichtigungen nach Wichtigkeit (INFO/WARNING/ALERT) | — | — |
| Paginierte Liste der Benachrichtigungen |
| — |
| Erstellt eine Benachrichtigung |
| — |
| Archiviert eine einzelne Benachrichtigung |
| — |
| Verschiebt eine archivierte Benachrichtigung zurück zu ungelesen |
| — |
| Berechnet die Übersichtszahlen neu | — | — |
| Archiviert alle ungelesenen Benachrichtigungen | optional | — |
| Archiviert spezifische Benachrichtigungen nach ID |
| — |
| De-archiviert spezifische Benachrichtigungen nach ID |
| — |
| Verschiebt alle archivierten Benachrichtigungen zurück zu ungelesen | optional | — |
| Löscht eine einzelne Benachrichtigung dauerhaft |
| * |
| Löscht alle archivierten Benachrichtigungen dauerhaft |
| * |
key — 7 Subactions
API-Schlüsselverwaltung. Destruktive Subactions sind mit * markiert.
Subaction | Beschreibung | Erforderliche Parameter | Destruktiv |
| Alle API-Schlüssel mit Rollen und Berechtigungen | — | — |
| Details eines einzelnen API-Schlüssels |
| — |
| Erstellt einen API-Schlüssel |
| — |
| Aktualisiert Name, Rollen oder Berechtigungen |
| — |
| Löscht einen API-Schlüssel (widerruft sofort den Zugriff) |
| * |
| Fügt einem bestehenden Schlüssel eine Rolle hinzu |
| — |
| Entfernt eine Rolle von einem bestehenden Schlüssel |
| — |
plugin — 3 Subactions
Unraid-Plugin-Verwaltung. Destruktive Subactions sind mit * markiert.
Subaction | Beschreibung | Erforderliche Parameter | Destruktiv |
| Alle installierten Plugins mit Version und Modul-Flags | — | — |
| Installiert Plugins nach Namen |
| — |
| Deinstalliert Plugins nach Namen (irreversibel ohne Neuinstallation) |
| * |
rclone — 4 Subactions
Verwaltung von Cloud-Speicher-Remotes. Destruktive Subactions sind mit * markiert.
Subaction | Beschreibung | Erforderliche Parameter | Destruktiv |
| Alle konfigurierten rclone-Remotes mit Typ und Parametern | — | — |
| Konfigurationsformular-Schema für einen Anbietertyp | optional | — |
| Erstellt ein neues rclone-Remote |
| — |
| Löscht eine rclone-Remote-Konfiguration (löscht keine Remote-Daten) |
| * |
setting — 2 Subactions
Systemeinstellungen. Destruktive Subactions sind mit * markiert.
Subaction | Beschreibung | Erforderliche Parameter | Destruktiv |
| Aktualisiert Systemeinstellungen (JSON-Schlüssel/Wert-Eingabe) |
| — |
| Überschreibt die USV-Überwachungskonfiguration |
| * |
customization — 5 Subactions
UI-Theme und SSO-Status.
| Subaction | Beschreibung | Erforder
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Appeared in Searches
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/jmagar/unraid-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server