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: unraid-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 deployed
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
Connect AI assistants to your GitHub-hosted Obsidian vault to seamlessly access, search, and analy…
Official Fibery MCP server: query and update your workspace from any AI client via OAuth.
Related MCP Servers
- AlicenseAqualityCmaintenanceA code-mode MCP server for the Unraid 7.2+ GraphQL API that exposes search and execute tools, allowing LLM agents to introspect and call any GraphQL field via sandboxed JavaScript.21MIT
- FlicenseNot gradedqualityBmaintenanceEnables AI assistants to manage Unraid OS via Docker, system calls, and file system access for automating array, share, and container operations.-
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI assistants like Claude to manage Unraid servers through natural language. Install it from Community Applications and control your homelab from any MCP-compatible AI client.3MIT
- AlicenseBqualityBmaintenanceA Model Context Protocol server that enables AI clients to inspect and manage an Unraid server via its GraphQL API, with read-only defaults and optional enabled mutations.88MIT