Unraid MCP
MCP-серверы для Unraid на Python и Rust: состояние массива, Docker, виртуальные машины и телеметрия через GraphQL
- 153 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент с правом записи способен остановить массив и сломать работающие службы
- Ключ API Unraid дает доступ к системе, его храните в настройках плагина, а не в репозитории
- Rust-сервер по умолчанию слушает все интерфейсы на порту 40010
Установка
- Работает в
Ручная установка
/plugin marketplace add dinglebear-ai/unraidПодключает маркетплейс репозитория, затем ставится `unraid-mcp@unraid-mcp`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент с правом записи способен остановить массив и сломать работающие службы
- Ключ API Unraid дает доступ к системе, его храните в настройках плагина, а не в репозитории
- Rust-сервер по умолчанию слушает все интерфейсы на порту 40010
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Репозиторий объединяет два MCP-сервера для домашнего сервера Unraid и три плагина для самой ОС. Python-сервер `unraid-mcp` публикуется в PyPI и запускается командой `uvx unraid-mcp`, Rust-сервер `runraid` собирается в один статический бинарник вместе с консольным клиентом. Оба ходят в GraphQL API Unraid по ключу `UNRAID_API_KEY`. Агент получает данные о системе, массиве дисков, контейнерах Docker, виртуальных машинах и уведомлениях, а также живую телеметрию. Python-сервер открывает единый инструмент `unraid`, опасные операции в нем требуют явного подтверждения. В Rust-сервере чтению соответствует область `unraid:read`, запуску и остановке виртуальных машин, контейнеров и массива область `unraid:admin`. Для Claude Code и Codex есть плагины в маркетплейсе репозитория, для Gemini CLI расширение.
Для кого. Владельцам домашних серверов и небольших лабораторий на Unraid, которые хотят спрашивать агента о состоянии дисков, контейнеров и виртуальных машин.
Подходит, если
- Массив показывает предупреждение, и агент читает состояние дисков и уведомления вместо ручного обхода панели
- Контейнер Docker завис, и агент смотрит его состояние и перезапускает его по явной просьбе
- Нужна сводка по нагрузке и температуре в живой телеметрии без входа в интерфейс
- Сервер работает в Docker на самом Unraid, а подключение идет по HTTP с токеном
Не подходит, если
- Нужен только просмотр без возможности менять систему: Rust-сервер умеет и изменять, поэтому выдайте ключ с областью чтения
- Нужно управлять другими NAS, например Synology или TrueNAS: серверы написаны под GraphQL API Unraid
- Unraid не обновлен до версии с GraphQL API: без него серверу нечего опрашивать
Пример запроса к агенту
Покажи состояние массива и дисков в Unraid, список остановленных контейнеров Docker и последние уведомленияMCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
UNRAID_API_URLобязательная- Адрес GraphQL API Unraid, например `https://tower.local/graphql`.
UNRAID_API_KEYобязательная, секрет- Ключ API Unraid для заголовка `x-api-key`.
UNRAID_RMCP_TOKENсекрет- Статический токен для `/mcp` в Rust-сервере.
Ограничения
Нужен адрес `UNRAID_API_URL` и ключ `UNRAID_API_KEY`, оба задаются обязательно. Rust-сервер не работает в режиме только для чтения: в нем есть и запросы, и изменения. По умолчанию он слушает `0.0.0.0:40010`, поэтому для сети нужны токен `UNRAID_RMCP_TOKEN` или OAuth. Флаг `UNRAID_API_SKIP_TLS_VERIFY` принимает самоподписанный сертификат, и включать его стоит только в доверенной сети. Репозиторий переименован из `unraid-mcp` в `unraid` 27 июля 2026 года, пакет PyPI и образ в ghcr.io сохранили старое имя.
Как отключить. Удалите плагин (`/plugin uninstall unraid-mcp@unraid-mcp`) или регистрацию сервера в клиенте, отзовите ключ в настройках Unraid и остановите контейнер, если запускали его в Docker.
Частые вопросы
Как подключить сервер к Claude Code?
Добавьте маркетплейс командой `/plugin marketplace add dinglebear-ai/unraid` и установите `/plugin install unraid-mcp@unraid-mcp`. Claude Code спросит адрес GraphQL API и ключ.
Чем Python-сервер отличается от Rust-сервера?
Python-сервер `unraid-mcp` главный и ставится из PyPI, а Rust-сервер `runraid` дает один бинарник и консольный клиент, умеет вводить токен и OAuth и разделяет области чтения и администрирования.
Может ли агент изменить состояние сервера?
Да, оба сервера содержат изменяющие операции: запуск и остановку виртуальных машин, контейнеров и массива. В Python-сервере опасные действия требуют подтверждения, в Rust-сервере им нужна область `unraid:admin`.
Какие переменные окружения обязательны?
`UNRAID_API_URL` с адресом GraphQL, например `https://tower.local/graphql`, и `UNRAID_API_KEY` с ключом API Unraid.
Можно ли запустить сервер в Docker?
Да, в репозитории есть `docker compose up -d` для Python-сервера, образ лежит в ghcr.io под именем `unraid-mcp`. Для Claude Desktop при необходимости подключаются через прокси `mcp-remote`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыНабор MCP-серверов для UniFi: агент работает с контроллерами Network, Protect и Access компании Ubiquiti
Менеджер MCP-серверов на Node.js: запускает локальные и подключает удаленные серверы и отдает их клиенту одним адресом с REST API для управления
Официальный MCP-сервер TrueNAS: вопросы о пулах, снимках, виртуальных машинах и приложениях на обычном языке.
MCP-сервер подключает агента к сети UniFi для диагностики устройств, проверки настроек и согласованных изменений
MCP-сервер мониторинга maintenant: агент читает логи контейнеров, историю проверок и алерты, но не трогает контейнеры
Docker MCP от QuantGeekDev
docker-mcp
Docker MCP: агент создает контейнеры, разворачивает стеки Docker Compose из YAML, читает логи и список контейнеров. Запуск через uvx для Claude Desktop
Коротко о README
Репозиторий описан как монорепо из двух MCP-серверов и трех плагинов Unraid с интеграциями для Claude и Codex. Дальше таблица компонентов, установка плагинов, быстрый старт Python- и Rust-серверов, таблица переменных окружения, оговорка о том, что Rust-сервер не только читает, и сведения о выпусках.