Unraid MCP Server
Unraid MCP
Servidor MCP respaldado por GraphQL para Unraid. Expone una herramienta unificada unraid para la inspección del sistema, operaciones de gestión, telemetría en vivo y acciones destructivas protegidas por confirmación explícita.
Descripción general
El servidor traduce las llamadas a herramientas MCP en consultas y mutaciones de GraphQL de Unraid a través de HTTP y WebSocket. Todas las operaciones comparten una única herramienta unraid enrutada por action + subaction. La telemetría en vivo utiliza suscripciones WebSocket que transmiten datos en tiempo real desde la API de Unraid.
Related MCP server: unraid-mcp-server
Qué incluye este repositorio
unraid_mcp/— servidor, cliente GraphQL, suscripciones WebSocket, configuración y manejadores de herramientasskills/unraid/— documentación de habilidades orientada al clientedocs/— referencias de autenticación, acciones destructivas y publicación.claude-plugin/,.codex-plugin/,gemini-extension.json— manifiestos de clientedocker-compose.yaml,Dockerfile,entrypoint.sh— despliegue en contenedortests/— pruebas unitarias, de seguridad, de esquema, de capa HTTP y de cobertura en vivo
Herramientas
Índice de herramientas
Herramienta | Propósito |
| Enrutador unificado de acción/subacción para todas las operaciones |
| Devuelve esta referencia como Markdown |
| Volcado de diagnóstico completo del sistema de suscripción WebSocket |
| Prueba una suscripción GraphQL sin procesar para trabajos de esquema/depuración |
unraid — grupos de acción
Todas las operaciones pasan por una sola herramienta. Elija una action y luego una subaction dentro de ella.
system — 18 subacciones
Información del servidor, métricas, red y SAI (UPS).
Subacción | Descripción | Parámetros requeridos |
| SO, CPU, diseño de memoria, versiones, ID de máquina | — |
| Estado de la matriz, capacidad, resumen de salud del disco | — |
| URLs de acceso, puertos HTTP/HTTPS, IPs LAN/WAN | — |
| Tipo de licencia, archivo de clave, expiración | — |
| Conjunto completo de variables de Unraid (zona horaria, recursos compartidos, etc.) | — |
| % de CPU en vivo y uso de memoria | — |
| Servicios en ejecución con nombre, estado en línea, versión | — |
| Nombre del tema de la interfaz de usuario actual | — |
| Validez de la configuración y estado de error | — |
| Verificación de accesibilidad booleana | — |
| Nombre de usuario del propietario, avatar, URL del perfil | — |
| Mapa de clave/valor de configuración unificada | — |
| Resumen de llamada única: nombre de host, tiempo de actividad, versión de Unraid, estado de la matriz | — |
| Todos los servidores registrados con IPs LAN/WAN y URLs | — |
| Información del proveedor y producto de la unidad flash | — |
| Todos los dispositivos SAI con métricas de batería y energía | — |
| Detalles de un solo dispositivo SAI |
|
| Configuración del demonio SAI | — |
health — 4 subacciones
Diagnóstico de conexión y salud del sistema.
Subacción | Descripción | Parámetros requeridos |
| Salud integral: latencia de API, estado de la matriz, alertas, resumen de contenedores Docker | — |
| Hacer ping a la API de Unraid y devolver la latencia en ms | — |
| Estado del sistema de suscripción, conteo de errores, estado de reconexión | — |
| Configuración interactiva de credenciales (admite elicitación MCP) | — |
array — 13 subacciones
Verificaciones de paridad y operaciones de disco de la matriz. Las subacciones destructivas están marcadas con *.
Subacción | Descripción | Parámetros requeridos | Destructiva |
| Progreso actual de la verificación de paridad, velocidad, errores | — | — |
| Resultados de verificaciones de paridad pasadas | — | — |
| Iniciar una verificación de paridad |
| — |
| Pausar una verificación de paridad en ejecución | — | — |
| Reanudar una verificación de paridad pausada | — | — |
| Cancelar una verificación de paridad en ejecución | — | — |
| Iniciar la matriz de Unraid | — | — |
| Detener la matriz de Unraid |
| * |
| Agregar un disco a la matriz |
| — |
| Eliminar un disco de la matriz (la matriz debe estar detenida) |
| * |
| Montar un disco de la matriz |
| — |
| Desmontar un disco de la matriz |
| — |
| Borrar estadísticas de E/S de un disco (irreversible) |
| * |
disk — 6 subacciones
Recursos compartidos, discos físicos, archivos de registro y copia de seguridad flash. Las subacciones destructivas están marcadas con *.
Subacción | Descripción | Parámetros requeridos | Destructiva |
| Todos los recursos compartidos de usuario con tamaño, configuración de asignación, estado LUKS | — | — |
| Lista de discos físicos (ID, dispositivo, nombre) | — | — |
| Disco único: serie, tamaño, temperatura |
| — |
| Listar archivos de registro disponibles (nombre, ruta, tamaño, modificado) | — | — |
| Leer contenido del archivo de registro con rango de líneas |
| — |
| Iniciar copia de seguridad rclone de la unidad flash a un remoto |
| * |
Detalles de flash_backup: Llama a la mutación GraphQL initiateFlashBackup de Unraid, que activa una copia rclone desde la unidad flash a un remoto rclone configurado. El destino en el remoto se sobrescribe si existe. Devuelve { status, jobId }. Para restaurar: use rclone para copiar la copia de seguridad de vuelta a la unidad flash, o extraiga archivos de configuración individuales. Configure el remoto rclone primero a través de rclone/create_remote.
docker — 7 subacciones
Ciclo de vida del contenedor e inspección de red. Sin subacciones destructivas.
Subacción | Descripción | Parámetros requeridos |
| Todos los contenedores: ID, nombres, imagen, estado, estatus, autoStart | — |
| Detalle completo del contenedor: puertos, montajes, etiquetas, configuración de red |
|
| Iniciar un contenedor |
|
| Detener un contenedor |
|
| Detener y luego iniciar un contenedor (detener + iniciar en secuencia) |
|
| Todas las redes Docker: ID, nombre, controlador, alcance | — |
| Red única con IPv6, contenedores, opciones, etiquetas |
|
Los identificadores de contenedor aceptan ID completo, prefijo de ID corto, nombre exacto o prefijo de nombre inequívoco. Las mutaciones (start, stop, restart) requieren un nombre exacto o ID completo.
vm — 9 subacciones
Ciclo de vida de la máquina virtual. Las subacciones destructivas están marcadas con *.
Subacción | Descripción | Parámetros requeridos | Destructiva |
| Todas las VM: ID, nombre, estado, UUID | — | — |
| Detalles de una sola VM |
| — |
| Iniciar una VM |
| — |
| Detener suavemente una VM |
| — |
| Pausar una VM en ejecución |
| — |
| Reanudar una VM pausada |
| — |
| Reiniciar una VM |
| — |
| Apagado forzado de una VM (posible pérdida de datos) |
| * |
| Reinicio forzado de una VM sin apagado suave |
| * |
vm_id acepta UUID, ID con prefijo o nombre de VM.
notification — 12 subacciones
CRUD de notificaciones del sistema. Las subacciones destructivas están marcadas con *.
Subacción | Descripción | Parámetros requeridos | Destructiva |
| Conteos de no leídos y archivados por importancia (INFO/WARNING/ALERT) | — | — |
| Lista de notificaciones paginada |
| — |
| Crear una notificación |
| — |
| Archivar una sola notificación |
| — |
| Mover una notificación archivada de vuelta a no leída |
| — |
| Recalcular los conteos de la vista general | — | — |
| Archivar todas las notificaciones no leídas | opcional | — |
| Archivar notificaciones específicas por ID |
| — |
| Desarchivar notificaciones específicas por ID |
| — |
| Mover todas las notificaciones archivadas de vuelta a no leídas | opcional | — |
| Eliminar permanentemente una sola notificación |
| * |
| Eliminar permanentemente todas las notificaciones archivadas |
| * |
key — 7 subacciones
Gestión de claves API. Las subacciones destructivas están marcadas con *.
Subacción | Descripción | Parámetros requeridos | Destructiva |
| Todas las claves API con roles y permisos | — | — |
| Detalles de una sola clave API |
| — |
| Crear una clave API |
| — |
| Actualizar nombre, roles o permisos |
| — |
| Eliminar una clave API (revoca el acceso inmediatamente) |
| * |
| Agregar un rol a una clave existente |
| — |
| Eliminar un rol de una clave existente |
| — |
plugin — 3 subacciones
Gestión de complementos de Unraid. Las subacciones destructivas están marcadas con *.
Subacción | Descripción | Parámetros requeridos | Destructiva |
| Todos los complementos instalados con versión y banderas de módulo | — | — |
| Instalar complementos por nombre |
| — |
| Desinstalar complementos por nombre (irreversible sin reinstalar) |
| * |
rclone — 4 subacciones
Gestión remota de almacenamiento en la nube. Las subacciones destructivas están marcadas con *.
Subacción | Descripción | Parámetros requeridos | Destructiva |
| Todos los remotos rclone configurados con tipo y parámetros | — | — |
| Esquema de formulario de configuración para un tipo de proveedor | opcional | — |
| Crear un nuevo remoto rclone |
| — |
| Eliminar una configuración remota rclone (no elimina datos remotos) |
| * |
setting — 2 subacciones
Configuración del sistema. Las subacciones destructivas están marcadas con *.
Subacción | Descripción | Parámetros requeridos | Destructiva |
| Actualizar la configuración del sistema (entrada JSON clave/valor) |
| — |
| Sobrescribir la configuración de monitoreo SAI |
| * |
customization — 5 subacciones
Tema de la interfaz de usuario y estado SSO.
Subacción | Descripción | Parámetros requeridos |
| Tema completo, información del socio y código de activación | — |
| Tema público e información del socio (vista no autenticada) | — |
| Si se ha completado el asistente de configuración inicial | — |
| Si SSO está habilitado | — |
| Establecer el tema de la interfaz de |
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