# Unraid RMCP

Управляет сервером Unraid через GraphQL API прямо из интерфейса ИИ-агента. Помогает проверять дисковые массивы, запускать виртуальные машины и контролировать Docker-контейнеры.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 143
- Автор: dinglebear-ai
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/dinglebear-ai/unraid
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/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`.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `UNRAID_API_URL`, `UNRAID_API_KEY`, `UNRAID_RMCP_VERSION`, `UNRAID_RMCP_REPO`, `UNRAID_RMCP_RELEASE_BASE_URL`, `RUST_LOG` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 сервера

## Когда брать
- проверить текущий статус и здоровье дискового массива Unraid
- перезапустить или остановить выбранные контейнеры Docker
- управлять питанием и состоянием виртуальных машин
- получать системные уведомления и предупреждения о сбоях накопителей

## Примеры запросов агенту
- Покажи статус массива Unraid и состояние подключённых дисков
- Останови контейнер plex и проверь потребление памяти
- Запусти виртуальную машину ubuntu-dev через Unraid API

## Похожие
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [Oh My Posh Validator](https://affpapa.org/nevibecode/mcp/oh-my-posh-validator.md) — MCP-сервер · ★ 23643
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18727
- [Coder](https://affpapa.org/nevibecode/mcp/coder.md) — MCP-сервер · ★ 17160
- [mcp](https://affpapa.org/nevibecode/mcp/kubeshark-mcp.md) — MCP-сервер · ★ 12109

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md