M
MCP Directory CURATED DIRECTORY
911 MCP servers indexed
中文
← Back to directory
U

Unraid

Community
Unraid RMCP - Rust MCP server and CLI for Unraid GraphQL operations.
How to install ↓ Compare GitHub source repository ↗
Category
Cloud Storage #15 of 15
Stars
★ 137 Very popular
Transport
stdio (local process)
Runtime
Node.js · Rust
Credentials
API key / credential required
License
MIT
Last commit
31FMRS · D

A community-maintained Rust MCP server for managing Unraid. It offers extensive tools but is not official, so careful permission configuration is advised.

Strongest · Documentation 8/20 Weakest · Reliability 4/20

Reliability
4/20
Security and permissions
6/20
Maintenance
6/20
Documentation
8/20
Setup experience
7/20
Why each score
Reliability 4/20
The manifest is well-formed and declares required env vars and an npx entrypoint, making a happy path plausible. However, only the manifest and README were supplied; no source, tests, CI, or tool-list evidence is available. The build/test commands in the README are untrusted and unverifiable here, so the MCP init/tool-list handshake and tool-to-behavior consistency cannot be confirmed. Deducted for missing execution evidence and thin edge-case/error handling.
Security and permissions 6/20
UNRAID_API_KEY is marked secret in the manifest, and the README distinguishes unraid:read from unraid:admin scopes for mutations. That is positive. But the npm wrapper downloads a prebuilt binary from GitHub at runtime with no checksum verification mentioned, and dangerous mutations (VM/Docker lifecycle, array start/stop) are only gated by admin scope, with no per-operation confirmation documented. Data-flow and OAuth details are not fully disclosed, so high marks are not warranted.
Maintenance 6/20
The repository is not archived, the MIT license is present, version 0.4.2 is declared, and the README describes release-please managing the Rust server with unraid-rs-vX.Y.Z tags. Still, no commit history, issue-response, dependency-update, or security-response evidence was supplied; stars and issue counts are discovery signals only and were not scored. Deducted for missing governance and sustained-maintenance evidence.
Documentation 8/20
The README provides a quickstart, an env-var table, CLI examples, auth modes, and scope notes, and points to CLAUDE.md for OAuth variables (not supplied). It lacks per-tool parameter documentation, limits, and a troubleshooting section, leaving hidden assumptions. This matches a usable-but-gapped documentation score.
Setup experience 7/20
The npx/npm package plus required env vars gives a plausible few-step install, and plugin marketplace commands are shown. However, there is no client config JSON example for mainstream clients, the binary must be fetched from GitHub at runtime (network-dependent and fragile), and no CI/tests verify the install path. Static calibration caps setup at 15 without verifiable execution evidence, so a conservative score is given.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the network

Best for

  • Developers familiar with Rust
  • Users who need to manage Unraid via CLI or MCP locally
  • Users who prefer a single static binary

Not for

  • Users needing official Unraid support
  • Users preferring Python ecosystem
  • Users needing GUI management

Required permissions

  • Requires Unraid API URL and API key
  • Read operations require `unraid:read` scope
  • Mutating operations require `unraid:admin` scope

Risks and side effects

  • Not an official Unraid tool, may lack support
  • Requires network access to Unraid server
  • API key exposure could be a security risk
  • Write operations could affect VM, Docker, or array state

Setup

Before you start

Runtime：Node.js · Rust

UNRAID_API_URL required Full Unraid GraphQL endpoint URL, e.g. https://unraid.example.com/graphql.
UNRAID_API_KEY requiredsecret Unraid API key, generated in the Unraid server's API settings.
UNRAID_RMCP_TOKEN optionalsecret Optional static bearer token for the /mcp endpoint.
Other optional settings (8)
UNRAID_RMCP_VERSION optional Optional GitHub release tag override for the downloaded Unraid RMCP binary, e.g. v0.2.2.
UNRAID_RMCP_REPO optional Optional GitHub owner/repo override for release asset downloads, default dinglebear-ai/unraid-mcp.
UNRAID_RMCP_RELEASE_BASE_URL optional Optional override for the release download base URL.
RUST_LOG optional Optional tracing filter for logs, defaults to info.
UNRAID_API_SKIP_TLS_VERIFY optional Optional; set to accept a self-signed Unraid cert, default false.
UNRAID_RMCP_HOST optional Optional MCP HTTP bind host, default 0.0.0.0.
UNRAID_RMCP_PORT optional Optional MCP HTTP bind port, default 40010.
UNRAID_RMCP_AUTH_MODE optional Optional auth mode: bearer (default) or oauth.

Install via npm: npx @dinglebear/unraid mcp. Set environment variables UNRAID_API_URL and UNRAID_API_KEY. Alternatively, build from source: cd unraid-rs && cargo build --release, then run runraid serve mcp.

Check that it works

After launch, ask the client for system info or array status; if it returns real data from your Unraid server, UNRAID_API_URL and UNRAID_API_KEY are set correctly and the connection works.

Troubleshooting

  1. Verify `UNRAID_API_URL` and `UNRAID_API_KEY`
  2. Ensure network connectivity to Unraid server
  3. Check logs with `RUST_LOG=debug`
  4. Validate SSL certificate or set `UNRAID_API_SKIP_TLS_VERIFY=true`

Things to try

Once connected, you can ask your AI assistant things like:

  • Show system info and current status of my Unraid server
  • List all running Docker containers on my Unraid box
  • Show the current array and parity status
  • Check for unread Unraid notifications

Use cases

Query Unraid system status
Manage Docker containers and VMs
Monitor array and parity
View and manipulate notifications
Manage plugins and rclone

Supported clients

Claude Desktop

Listed from the project's documentation, not tested by this site.

Overview

A Rust MCP server that queries, monitors, and manages Unraid servers via GraphQL API. Supports system info, Docker, VMs, array/parity, notifications, plugins, rclone, and live telemetry.

Similar servers

Compare with other MCP servers

More servers from this repository

Unraid MCP

Source revision 6d00e73cd7dd Data synced 2026-10-12 Read the FMRS scoring method