Unraid RMCP — MCP-сервер для Claude Code: что делает и как установить
Управляет сервером Unraid через GraphQL API прямо из интерфейса ИИ-агента. Помогает проверять дисковые массивы, запускать виртуальные машины и контролировать Docker-контейнеры.
claude mcp add --env UNRAID_API_URL=<UNRAID_API_URL> --env UNRAID_API_KEY=<UNRAID_API_KEY> --env UNRAID_RMCP_VERSION=<UNRAID_RMCP_VERSION> --env UNRAID_RMCP_REPO=<UNRAID_RMCP_REPO> --env UNRAID_RMCP_RELEASE_BASE_URL=<UNRAID_RMCP_RELEASE_BASE_URL> --transport stdio unraid-rmcp -- npx -y @dinglebear/unraidЧто делает Unraid RMCP
Сервер написан на Rust и поставляется в виде скомпилированного бинарника runraid либо запускается через вспомогательный npm-пакет @dinglebear/unraid. Инструмент связывается с GraphQL-эндпоинтом Unraid OS и передаёт агенту доступ к инфраструктуре: состоянию накопителей, службам и системным оповещениям.
Инструмент не ограничен чтением. Он выполняет мутации. По этой причине для управления жизненным циклом контейнеров, виртуальных машин или остановки массива потребуется токен с правами unraid:admin. Для простых отчётов о состоянии дисков хватит скоупа unraid:read.
Без рабочих переменных UNRAID_API_URL и UNRAID_API_KEY запросы не пройдут. Если на домашнем сервере используется самоподписанный TLS-сертификат, придётся также выставить UNRAID_API_SKIP_TLS_VERIFY=true.
Какие задачи решает
- проверить текущий статус и здоровье дискового массива Unraid
- перезапустить или остановить выбранные контейнеры Docker
- управлять питанием и состоянием виртуальных машин
- получать системные уведомления и предупреждения о сбоях накопителей
Примеры запросов агенту
- Покажи статус массива Unraid и состояние подключённых дисков
- Останови контейнер plex и проверь потребление памяти
- Запусти виртуальную машину ubuntu-dev через Unraid API
Как установить Unraid RMCP
Командой платформы
claude mcp add --env UNRAID_API_URL=<UNRAID_API_URL> --env UNRAID_API_KEY=<UNRAID_API_KEY> --env UNRAID_RMCP_VERSION=<UNRAID_RMCP_VERSION> --env UNRAID_RMCP_REPO=<UNRAID_RMCP_REPO> --env UNRAID_RMCP_RELEASE_BASE_URL=<UNRAID_RMCP_RELEASE_BASE_URL> --transport stdio unraid-rmcp -- npx -y @dinglebear/unraidВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
codex mcp add unraid-rmcp --env UNRAID_API_URL=<UNRAID_API_URL> --env UNRAID_API_KEY=<UNRAID_API_KEY> --env UNRAID_RMCP_VERSION=<UNRAID_RMCP_VERSION> --env UNRAID_RMCP_REPO=<UNRAID_RMCP_REPO> --env UNRAID_RMCP_RELEASE_BASE_URL=<UNRAID_RMCP_RELEASE_BASE_URL> -- npx -y @dinglebear/unraidВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"mcpServers": {
"unraid-rmcp": {
"command": "npx",
"args": [
"-y",
"@dinglebear/unraid"
],
"env": {
"UNRAID_API_URL": "<UNRAID_API_URL>",
"UNRAID_API_KEY": "<UNRAID_API_KEY>",
"UNRAID_RMCP_VERSION": "<UNRAID_RMCP_VERSION>",
"UNRAID_RMCP_REPO": "<UNRAID_RMCP_REPO>",
"UNRAID_RMCP_RELEASE_BASE_URL": "<UNRAID_RMCP_RELEASE_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"servers": {
"unraid-rmcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@dinglebear/unraid"
],
"env": {
"UNRAID_API_URL": "<UNRAID_API_URL>",
"UNRAID_API_KEY": "<UNRAID_API_KEY>",
"UNRAID_RMCP_VERSION": "<UNRAID_RMCP_VERSION>",
"UNRAID_RMCP_REPO": "<UNRAID_RMCP_REPO>",
"UNRAID_RMCP_RELEASE_BASE_URL": "<UNRAID_RMCP_RELEASE_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
gemini mcp add -e UNRAID_API_URL=<UNRAID_API_URL> -e UNRAID_API_KEY=<UNRAID_API_KEY> -e UNRAID_RMCP_VERSION=<UNRAID_RMCP_VERSION> -e UNRAID_RMCP_REPO=<UNRAID_RMCP_REPO> -e UNRAID_RMCP_RELEASE_BASE_URL=<UNRAID_RMCP_RELEASE_BASE_URL> unraid-rmcp npx -y @dinglebear/unraidВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Unraid RMCP
Как установить Unraid RMCP в Claude Code?
Выполните команду claude mcp add unraid -e UNRAID_API_URL=<UNRAID_API_URL> -e UNRAID_API_KEY=<UNRAID_API_KEY> -- npx -y @dinglebear/unraid, подставив адрес своего эндпоинта и ключ авторизации.
Что делает Unraid RMCP?
Он предоставляет интерфейс MCP для взаимодействия с Unraid OS через GraphQL. Ассистент сможет считывать метрики накопителей, отправлять команды виртуальным машинам и менять состояние контейнеров.
Какие права доступа требуются для работы сервера?
Чтение данных требует скоупа unraid:read. Для управления питанием массива, запуска виртуалок и изменения Docker-контейнеров ключу необходим скоуп unraid:admin.
