Unraid MCP Server
Unraid MCP
MCP-сервер на базе GraphQL для Unraid. Предоставляет унифицированный инструмент unraid для проверки системы, операций управления, телеметрии в реальном времени и деструктивных действий, требующих явного подтверждения.
Обзор
Сервер преобразует вызовы инструментов MCP в GraphQL-запросы и мутации Unraid по протоколам HTTP и WebSocket. Все операции используют единый инструмент unraid, маршрутизируемый через action + subaction. Телеметрия в реальном времени использует WebSocket-подписки, которые транслируют данные из API Unraid.
Related MCP server: unraid-mcp-server
Что входит в этот репозиторий
unraid_mcp/— сервер, GraphQL-клиент, WebSocket-подписки, конфигурация и обработчики инструментовskills/unraid/— документация по навыкам для клиентовdocs/— справочные материалы по аутентификации, деструктивным действиям и публикации.claude-plugin/,.codex-plugin/,gemini-extension.json— манифесты клиентовdocker-compose.yaml,Dockerfile,entrypoint.sh— развертывание в контейнереtests/— модульные, функциональные, схемные, HTTP-уровневые тесты и тесты с реальным сервером
Инструменты
Индекс инструментов
Инструмент | Назначение |
| Унифицированный маршрутизатор действий/поддействий для всех операций |
| Возвращает эту справку в формате Markdown |
| Полный диагностический дамп системы WebSocket-подписок |
| Проверка необработанной GraphQL-подписки для отладки схемы |
unraid — группы действий
Все операции выполняются через один инструмент. Выберите action, а затем subaction внутри него.
system — 18 поддействий
Информация о сервере, метрики, сеть и ИБП.
Поддействие | Описание | Обязательные параметры |
| ОС, CPU, компоновка памяти, версии, ID машины | — |
| Состояние массива, емкость, сводка состояния дисков | — |
| URL доступа, порты HTTP/HTTPS, LAN/WAN IP | — |
| Тип лицензии, файл ключа, срок действия | — |
| Полный набор переменных Unraid (часовой пояс, общие ресурсы и т.д.) | — |
| Текущая загрузка CPU % и использование памяти | — |
| Запущенные службы: имя, статус, версия | — |
| Имя текущей темы интерфейса | — |
| Валидность конфигурации и состояние ошибок | — |
| Проверка доступности (boolean) | — |
| Имя владельца, аватар, URL профиля | — |
| Унифицированная карта настроек ключ/значение | — |
| Сводка одним вызовом: имя хоста, время работы, версия Unraid, состояние массива | — |
| Все зарегистрированные серверы с LAN/WAN IP и URL | — |
| Информация о производителе и модели флеш-накопителя | — |
| Все устройства ИБП с метриками батареи и питания | — |
| Детали одного устройства ИБП |
|
| Конфигурация демона ИБП | — |
health — 4 поддействия
Диагностика соединения и состояния системы.
Поддействие | Описание | Обязательные параметры |
| Комплексная проверка: задержка API, состояние массива, оповещения, сводка Docker-контейнеров | — |
| Пинг API Unraid и возврат задержки в мс | — |
| Статус системы подписок, счетчики ошибок, состояние переподключения | — |
| Интерактивная настройка учетных данных (поддерживает вызов MCP) | — |
array — 13 поддействий
Проверки четности и операции с дисками массива. Деструктивные поддействия отмечены *.
Поддействие | Описание | Обязательные параметры | Деструктивно |
| Текущий прогресс проверки четности, скорость, ошибки | — | — |
| Результаты прошлых проверок четности | — | — |
| Запуск проверки четности |
| — |
| Приостановка проверки четности | — | — |
| Возобновление проверки четности | — | — |
| Отмена проверки четности | — | — |
| Запуск массива Unraid | — | — |
| Остановка массива Unraid |
| * |
| Добавление диска в массив |
| — |
| Удаление диска из массива (массив должен быть остановлен) |
| * |
| Монтирование диска массива |
| — |
| Размонтирование диска массива |
| — |
| Очистка статистики I/O диска (необратимо) |
| * |
disk — 6 поддействий
Общие ресурсы, физические диски, файлы журналов и резервное копирование флеш-накопителя. Деструктивные поддействия отмечены *.
Поддействие | Описание | Обязательные параметры | Деструктивно |
| Все пользовательские ресурсы с размером, настройками размещения, статусом LUKS | — | — |
| Список физических дисков (ID, устройство, имя) | — | — |
| Один диск: серийный номер, размер, температура |
| — |
| Список доступных файлов журналов (имя, путь, размер, дата изменения) | — | — |
| Чтение содержимого файла журнала с указанием диапазона строк |
| — |
| Запуск резервного копирования флеш-накопителя через rclone на удаленный ресурс |
| * |
Детали flash_backup: Вызывает мутацию GraphQL initiateFlashBackup, которая запускает копирование rclone с флеш-накопителя на настроенный удаленный ресурс rclone. Если целевой файл существует, он будет перезаписан. Возвращает { status, jobId }. Для восстановления: используйте rclone для копирования резервной копии обратно на флеш-накопитель или извлеките отдельные файлы конфигурации. Сначала настройте удаленный ресурс rclone через rclone/create_remote.
docker — 7 поддействий
Жизненный цикл контейнеров и проверка сети. Деструктивных поддействий нет.
Поддействие | Описание | Обязательные параметры |
| Все контейнеры: ID, имена, образ, состояние, статус, autoStart | — |
| Полные детали контейнера: порты, монтирования, метки, настройки сети |
|
| Запуск контейнера |
|
| Остановка контейнера |
|
| Перезапуск контейнера (остановка + запуск) |
|
| Все сети Docker: ID, имя, драйвер, область действия | — |
| Одна сеть с IPv6, контейнерами, опциями, метками |
|
Идентификаторы контейнеров принимают полный ID, короткий префикс ID, точное имя или однозначный префикс имени. Мутации (start, stop, restart) требуют точного имени или полного ID.
vm — 9 поддействий
Жизненный цикл виртуальных машин. Деструктивные поддействия отмечены *.
Поддействие | Описание | Обязательные параметры | Деструктивно |
| Все ВМ: ID, имя, состояние, UUID | — | — |
| Детали одной ВМ |
| — |
| Запуск ВМ |
| — |
| Корректная остановка ВМ |
| — |
| Приостановка работающей ВМ |
| — |
| Возобновление приостановленной ВМ |
| — |
| Перезагрузка ВМ |
| — |
| Принудительное выключение ВМ (возможна потеря данных) |
| * |
| Жесткая перезагрузка ВМ без корректного завершения |
| * |
vm_id принимает UUID, префикс ID или имя ВМ.
notification — 12 поддействий
CRUD системных уведомлений. Деструктивные поддействия отмечены *.
Поддействие | Описание | Обязательные параметры | Деструктивно |
| Количество непрочитанных и архивных уведомлений по важности (INFO/WARNING/ALERT) | — | — |
| Пагинированный список уведомлений |
| — |
| Создание уведомления |
| — |
| Архивация одного уведомления |
| — |
| Перемещение архивного уведомления обратно в непрочитанные |
| — |
| Пересчет количества уведомлений | — | — |
| Архивация всех непрочитанных уведомлений | опционально | — |
| Архивация нескольких уведомлений по ID |
| — |
| Разархивация нескольких уведомлений по ID |
| — |
| Перемещение всех архивных уведомлений обратно в непрочитанные | опционально | — |
| Безвозвратное удаление одного уведомления |
| * |
| Безвозвратное удаление всех архивных уведомлений |
| * |
key — 7 поддействий
Управление ключами API. Деструктивные поддействия отмечены *.
Поддействие | Описание | Обязательные параметры | Деструктивно |
| Все ключи API с ролями и разрешениями | — | — |
| Детали одного ключа API |
| — |
| Создание ключа API |
| — |
| Обновление имени, ролей или разрешений |
| — |
| Удаление ключа API (немедленно отзывает доступ) |
| * |
| Добавление роли к существующему ключу |
| — |
| Удаление роли из существующего ключа |
| — |
plugin — 3 поддействия
Управление плагинами Unraid. Деструктивные поддействия отмечены *.
Поддействие | Описание | Обязательные параметры | Деструктивно |
| Все установленные плагины с версией и флагами модулей | — | — |
| Установка плагинов по имени |
| — |
| Удаление плагинов по имени (необратимо без переустановки) |
| * |
rclone — 4 поддействия
Управление удаленными хранилищами rclone. Деструктивные поддействия отмечены *.
Поддействие | Описание | Обязательные параметры | Деструктивно |
| Все настроенные удаленные ресурсы rclone с типом и параметрами | — | — |
| Схема формы конфигурации для типа провайдера | опционально | — |
| Создание нового удаленного ресурса rclone |
| — |
| Удаление конфигурации удаленного ресурса rclone (не удаляет данные на удаленном ресурсе) |
| * |
setting — 2 поддействия
Системные настройки. Деструктивные поддействия отмечены *.
Поддействие | Описание | Обязательные параметры | Деструктивно |
| Обновление системных настроек (ввод JSON ключ/значение) |
| — |
| Перезапись конфигурации мониторинга ИБП |
| * |
customization — 5 поддействий
Тема интерфейса
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