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-code-mode-mcp
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…
Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.
Connect AI assistants to your GitHub-hosted Obsidian vault to seamlessly access, search, and analy…
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceProvides read-only server monitoring and diagnostic tools for AI assistants to manage Linux and Unraid systems via SSH. It enables natural language interactions for container management, storage health checks, and system log analysis while keeping credentials secure.17ISC
- AlicenseAqualityDmaintenanceA 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.2MIT