Skip to main content
Glama
dinglebear-ai

Unraid MCP Server

Unraid

PyPI ghcr.io

A monorepo of Unraid tooling: two MCP servers (Python and Rust) and three Unraid OS plugins, plus the Claude/Codex agent integrations that surface them.

Components

Path

What it is

Toolchain

Build / test

unraid-py/

unraid-mcp — Python MCP server (GraphQL), the flagship. Published to PyPI as unraid-mcp.

Python / uv / hatchling

cd unraid-py && uv run pytest && uv build --wheel

unraid-rs/

runraid — Rust MCP server + CLI (single static binary), unraid-rmcp on npm.

Rust / cargo

cd unraid-rs && cargo fmt --check && cargo clippy --all-targets -- -D warnings && cargo test

plugins/mcp/

Unraid OS plugin that ships the Python MCP server onto an Unraid box.

shell .plg + Python

bash plugins/mcp/scripts/build-txz.sh <ver> <wheel>

plugins/incus/

Unraid OS plugin running Incus system containers ("dev containers") firewalled off the LAN. Includes a NestJS/GraphQL unraid-api backend.

shell .plg + NestJS/Vue

cd plugins/incus && ./scripts/verify-classic-package.sh && ./tests/classic-contract.sh

plugins/codex/

Unraid OS plugin embedding a Codex chathead app-server.

shell .plg + React

cd plugins/codex && ./tests/contract.sh

agents/unraid-py/

Claude Code / Codex plugin (name: unraid-mcp) for the Python server.

agents/unraid-rs/

Claude Code / Codex plugin (name: runraid) for the Rust server.

Related MCP server: MCP SSH SRE

Install the agent plugins (one marketplace command, two manifests)

/plugin marketplace add dinglebear-ai/unraid
/plugin install unraid-mcp@unraid-mcp   # Python server
/plugin install runraid@unraid-mcp      # Rust server

Both plugins are published from a single repo. Claude reads .claude-plugin/marketplace.json; Codex reads .agents/plugins/marketplace.json. meta-ci.yml asserts the two list the same plugin set, so they cannot drift.

marketplace add accepts the owner/repo shorthand (or a full git URL / local path). After install, Claude Code prompts for the connection settings (the plugin's userConfig) and persists them to ~/.unraid-mcp/.env.

unraid-py quickstart (Python MCP server)

The Python server is the flagship. Full documentation — installation, Claude Code / Codex / Gemini setup, configuration, authentication, guardrails, and the tool surface — lives in unraid-py/README.md and unraid-py/docs/. It publishes to PyPI as unraid-mcp (import package unraid_mcp) and launches with uvx unraid-mcp.

Releases

Versioning is driven by release-please across all four release units. The Python server keeps unprefixed vX.Y.Z tags (the existing audience's scheme); the other components use prefixed tags: unraid-rs-vX.Y.Z, incus-vX.Y.Z, codex-vX.Y.Z. Plugin .txz payloads ship as GitHub release assets, not tracked in git.

License

MIT — see LICENSE.

A
license - permissive license
-
quality - not tested
B
maintenance

Maintenance

Maintainers
2dResponse time
4dRelease cycle
27Releases (12mo)
Commit activity
Issues opened vs closed

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/dinglebear-ai/unraid'

If you have feedback or need assistance with the MCP directory API, please join our Discord server