jmagar/unraid-mcp
57 stars · Last commit 2026-04-15
Query, monitor, and manage Unraid servers via GraphQL API through MCP tools. Supports system info, Docker, VMs, array/parity, notifications, plugins, rclone, and live telemetry.
README preview
# Unraid MCP <!-- mcp-name: tv.tootie/unraid-mcp --> [](https://pypi.org/project/unraid-mcp/) [](https://github.com/jmagar/unraid-mcp/pkgs/container/unraid-mcp) GraphQL-backed MCP server for Unraid. Exposes a unified `unraid` tool for system inspection, management operations, live telemetry, and destructive actions gated by explicit confirmation. ## Overview The server translates MCP tool calls into Unraid GraphQL queries and mutations over HTTP and WebSocket. All operations share a single `unraid` tool routed by `action` + `subaction`. Live telemetry uses WebSocket subscriptions that stream real-time data from the Unraid API. ## What this repository ships - `unraid_mcp/` — server, GraphQL client, WebSocket subscriptions, config, and tool handlers - `skills/unraid/` — client-facing skill docs - `docs/` — authentication, destructive-action, and publishing references - `.claude-plugin/`, `.codex-plugin/`, `gemini-extension.json` — client manifests - `docker-compose.yaml`, `Dockerfile`, `entrypoint.sh` — container deployment - `tests/` — unit, safety, schema, HTTP-layer, and live coverage