mirror of https://github.com/jmagar/unraid-mcp.git synced 2026-03-23 12:39:24 -07:00

Files

Jacob Magar f69aa94826 feat(dx): add fastmcp.json configs, module-level tool registration, tool timeout

- Add fastmcp.http.json and fastmcp.stdio.json declarative server configs
  for streamable-http (:6970) and stdio transports respectively
- Move register_all_modules() to module level in server.py so
  `fastmcp run server.py --reload` discovers the fully-wired mcp object
  without going through run_server() — tools registered exactly once
- Add timeout=120 to @mcp.tool() decorator as a global safety net;
  any hung subaction returns a clean MCP error instead of hanging forever
- Document fastmcp run --reload, fastmcp list, fastmcp call in README
- Bump version 1.0.1 → 1.1.0

Co-authored-by: Claude <claude@anthropic.com>

2026-03-16 10:32:16 -04:00

marketplace.json

fix: address all 17 PR review comments

2026-03-16 02:58:54 -04:00

plugin.json

feat(dx): add fastmcp.json configs, module-level tool registration, tool timeout

2026-03-16 10:32:16 -04:00

README.md

fix: address markdown lint and doc accuracy issues (threads 6-13)

2026-03-16 10:01:25 -04: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:

1 consolidated unraid tool with ~108 actions across 15 domains
Real-time live subscriptions (CPU, memory, logs, array state, UPS)
Disk health and temperature monitoring
Docker container management
VM status and control
Log file access
Network share information
Notification management
Plugin, rclone, API key, and OIDC management

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

Configuration

After installation, run setup to configure credentials interactively:

unraid(action="health", subaction="setup")

Credentials are stored at ~/.unraid-mcp/.env automatically.

Getting an API Key:

Open Unraid WebUI
Go to Settings → Management Access → API Keys
Click "Create" and select "Viewer" role (or appropriate roles for mutations)
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