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

Files

Jacob Magar 91244b66ff fix: address 5 critical and major PR review issues

- Remove set -e from validate-marketplace.sh to prevent early exit on
  check failures, allowing the summary to always be displayed (PRRT_kwDOO6Hdxs5uvKrc)
- Fix marketplace.json source path to point to skills/unraid instead of
  ./ for correct plugin directory resolution (PRRT_kwDOO6Hdxs5uvKrg)
- Fix misleading trap registration comment in unraid-api-crawl.md and
  add auth note to Apollo Studio URL (PRRT_kwDOO6Hdxs5uvO2t)
- Extract duplicated cleanup-with-error-handling in main.py into
  _run_shutdown_cleanup() helper (PRRT_kwDOO6Hdxs5uvO3A)
- Add input validation to read-logs.sh to prevent GraphQL injection
  via LOG_NAME and LINES parameters (PRRT_kwDOO6Hdxs5uvKrj)

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

marketplace.json

fix: address 5 critical and major PR review issues

2026-02-15 23:03:01 -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

fix: address 54 MEDIUM/LOW priority PR review issues

2026-02-15 17:09:31 -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 90 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