Runraid

•
3
•

Provides a Rust-based MCP server and CLI for querying Unraid NAS status, including array, Docker, VM, and storage health via GraphQL, strictly limited to read-only operations.

Runraid is a Rust-engineered Model Context Protocol (MCP) server and command-line interface designed to streamline interactions with an Unraid Network Attached Storage (NAS) system. It leverages the Unraid GraphQL API to offer comprehensive read-only access to critical system information, including array health, disk status, Docker container metrics and logs, virtual machine states, share details, notifications, system metrics, and more. This tool is built with a strong emphasis on safety, exposing no mutation actions to prevent unintended changes to your Unraid setup. It enables powerful automation workflows for monitoring and reporting Unraid system states, making it an ideal component for homelab environments and AI agent integrations seeking reliable, non-intrusive access to Unraid data.

주요 기능

01Multiple Runtime Surfaces: Supports stdio MCP for local child processes, streamable HTTP MCP for shared deployments, and a direct CLI for scriptable operations.
02Data Control and Efficiency: Provides pagination, filtering for list actions, and output truncation for large MCP responses, optimizing data retrieval.
03Comprehensive Unraid Data Querying: Access array health, disk SMART status, Docker containers/logs, VMs, shares, network settings, system metrics, UPS, and plugins.
04Strict Read-Only Operations: Ensures system integrity by strictly exposing read-only actions, preventing any mutations to Unraid array, Docker, or VM state.
05Flexible Authentication Options: Offers static bearer tokens, Google OAuth integration, or loopback development mode without authentication for HTTP MCP deployments.
063 GitHub stars

사용 사례

01Developing custom scripts and tools for Unraid system information, log analysis, and configuration variable inspection.
02Automating Unraid NAS status checks for array health, disk diagnostics, Docker container states, and VM performance.
03Integrating Unraid monitoring and data retrieval capabilities into AI agents and automation workflows via the Model Context Protocol (MCP).