Unraid MCP Server
Unraid MCP
MCP-сервер на базе GraphQL для Unraid. Предоставляет унифицированный инструмент unraid для проверки системы, операций управления, телеметрии в реальном времени и деструктивных действий, требующих явного подтверждения.
Обзор
Сервер преобразует вызовы инструментов MCP в GraphQL-запросы и мутации Unraid по протоколам HTTP и WebSocket. Все операции используют единый инструмент unraid, маршрутизируемый через action + subaction. Телеметрия в реальном времени использует WebSocket-подписки, которые транслируют данные из API Unraid.
Related MCP server: Model Control Plane (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 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