mirror of https://github.com/jmagar/unraid-mcp.git synced 2026-03-01 16:04:24 -08:00

Files

Jacob Magar 890bc544a1 fix: correct marketplace.json source field and improve async operations

- Fix marketplace.json: change source from relative path to GitHub URL
  (was "skills/unraid", now "https://github.com/jmagar/unraid-mcp")
  This resolves the "Invalid input" schema validation error when adding
  the marketplace to Claude Code

- Refactor subscriptions autostart to use anyio.Path for async file checks
  (replaces blocking pathlib.Path.exists() with async anyio.Path.exists())

- Update dependencies: anyio 4.11.0→4.12.1, attrs 25.3.0→25.4.0

2026-02-16 16:38:43 -05:00

marketplace.json

fix: correct marketplace.json source field and improve async operations

2026-02-16 16:38:43 -05:00

plugin.json

feat: harden API safety and expand command docs with full test coverage

2026-02-15 22:15:51 -05:00

README.md

docs: fix markdown lint, broken links, stale counts, and publishing guidance

2026-02-15 23:05:05 -05:00

README.md

Unraid MCP Marketplace

This directory contains the Claude Code marketplace configuration for the Unraid MCP server and skills.

Installation

From GitHub (Recommended)

# Add the marketplace
/plugin marketplace add jmagar/unraid-mcp

# Install the Unraid skill
/plugin install unraid @unraid-mcp

From Local Path (Development)

# Add local marketplace
/plugin marketplace add /path/to/unraid-mcp

# Install the plugin
/plugin install unraid @unraid-mcp

Available Plugins

unraid

Query and monitor Unraid servers via GraphQL API - array status, disk health, containers, VMs, system monitoring.

Features:

10 tools with 76 actions (queries and mutations)
Real-time system metrics
Disk health and temperature monitoring
Docker container management
VM status and control
Log file access
Network share information
Notification management

Version: 0.2.0 Category: Infrastructure Tags: unraid, monitoring, homelab, graphql, docker, virtualization

Configuration

After installation, configure your Unraid server credentials:

export UNRAID_API_URL="https://your-unraid-server/graphql"
export UNRAID_API_KEY="your-api-key"

Getting an API Key:

Open Unraid WebUI
Go to Settings → Management Access → API Keys
Click "Create" and select "Viewer" role
Copy the generated API key

Documentation

Plugin Documentation: See skills/unraid/README.md
MCP Server Documentation: See root README.md
API Reference: See skills/unraid/references/

Support

Issues: https://github.com/jmagar/unraid-mcp/issues
Repository: https://github.com/jmagar/unraid-mcp