Unraid RMCP MCP Server

by dinglebear-aiai.dinglebear/unraidv0.3.0

Rust MCP server and CLI for Unraid GraphQL operations across NAS, Docker, VM, and storage workflows.

135Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active9d ago

Install Unraid RMCP MCP server

claude mcp add unraid -e UNRAID_API_URL='<unraid-api-url>' -e UNRAID_API_KEY='<unraid-api-key>' -- npx -y @dinglebear/unraid mcp

{
  "mcpServers": {
    "unraid": {
      "command": "npx",
      "args": [
        "-y",
        "@dinglebear/unraid",
        "mcp"
      ],
      "env": {
        "UNRAID_API_URL": "<unraid-api-url>",
        "UNRAID_API_KEY": "<unraid-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "unraid": {
      "command": "npx",
      "args": [
        "-y",
        "@dinglebear/unraid",
        "mcp"
      ],
      "env": {
        "UNRAID_API_URL": "<unraid-api-url>",
        "UNRAID_API_KEY": "<unraid-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "unraid": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@dinglebear/unraid",
        "mcp"
      ],
      "env": {
        "UNRAID_API_URL": "<unraid-api-url>",
        "UNRAID_API_KEY": "<unraid-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "unraid": {
      "command": "npx",
      "args": [
        "-y",
        "@dinglebear/unraid",
        "mcp"
      ],
      "env": {
        "UNRAID_API_URL": "<unraid-api-url>",
        "UNRAID_API_KEY": "<unraid-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
UNRAID_API_URL	yes	—	Full Unraid GraphQL endpoint URL.
UNRAID_API_KEY	yes	yes	Unraid API key.
UNRAID_RMCP_VERSION	—	—	Optional GitHub release tag override for the downloaded Unraid RMCP binary.
UNRAID_RMCP_REPO	—	—	Optional GitHub owner/repo override for release asset downloads.
UNRAID_RMCP_RELEASE_BASE_URL	—	—	Optional release download base URL override.
RUST_LOG	—	—	Tracing filter for Unraid RMCP logs.

Freshness

Active — last maintenance signal 9d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-01 · 9d ago · GitHub
Latest release
2026-09-28 · 11d ago · GitHub · v2.10.2
Package published
no data · npm/PyPI
Registry entry updated
2026-08-04 · 2mo ago · official registry · v0.3.0

FAQ

›How do I install the Unraid RMCP MCP server in Claude Code?

Run: claude mcp add unraid -e UNRAID_API_URL='<unraid-api-url>' -e UNRAID_API_KEY='<unraid-api-key>' -- npx -y @dinglebear/unraid mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Unraid RMCP require an API key?

Yes. It expects UNRAID_API_URL, UNRAID_API_KEY, of which 1 is a secret.

›Can I use Unraid RMCP as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Unraid RMCP in the official MCP registry?

Yes, as ai.dinglebear/unraid.