Skip to main content
Glama
dinglebear-ai

Unraid MCP Server

Unraid MCP

PyPI ghcr.io

GraphQL ベースの Unraid 用 MCP サーバー。システム検査、管理操作、ライブテレメトリ、および明示的な確認が必要な破壊的アクションのための統合された unraid ツールを提供します。

概要

このサーバーは、MCP ツール呼び出しを HTTP および WebSocket 経由の Unraid GraphQL クエリとミューテーションに変換します。すべての操作は、action + subaction によってルーティングされる単一の unraid ツールを共有します。ライブテレメトリは、Unraid API からリアルタイムデータをストリーミングする WebSocket サブスクリプションを使用します。

Related MCP server: unraid-code-mode-mcp

このリポジトリの内容

  • unraid_mcp/ — サーバー、GraphQL クライアント、WebSocket サブスクリプション、設定、およびツールハンドラー

  • skills/unraid/ — クライアント向けスキルドキュメント

  • docs/ — 認証、破壊的アクション、および公開に関するリファレンス

  • .claude-plugin/, .codex-plugin/, gemini-extension.json — クライアントマニフェスト

  • docker-compose.yaml, Dockerfile, entrypoint.sh — コンテナデプロイメント

  • tests/ — ユニットテスト、安全性テスト、スキーマテスト、HTTP レイヤーテスト、およびライブカバレッジテスト

ツール

ツール一覧

ツール

目的

unraid

すべての操作のための統合されたアクション/サブアクションルーター

unraid_help

このリファレンスを Markdown で返す

diagnose_subscriptions

WebSocket サブスクリプションシステムの完全な診断ダンプ

test_subscription_query

スキーマ/デバッグ作業のために生の GraphQL サブスクリプションをプローブする

unraid — アクショングループ

すべての操作は 1 つのツールを経由します。action を選択し、その中の subaction を選択してください。

system — 18 個のサブアクション

サーバー情報、メトリクス、ネットワーク、および UPS。

サブアクション

説明

必須パラメータ

overview

OS、CPU、メモリレイアウト、バージョン、マシン ID

array

アレイの状態、容量、ディスク健全性サマリー

network

アクセス URL、HTTP/HTTPS ポート、LAN/WAN IP

registration

ライセンスタイプ、キーファイル、有効期限

variables

Unraid 変数セット全体 (タイムゾーン、共有など)

metrics

ライブ CPU % およびメモリ使用量

services

実行中のサービス (名前、オンライン状態、バージョン)

display

現在の UI テーマ名

config

設定の妥当性とエラー状態

online

到達可能性のブール値チェック

owner

オーナーのユーザー名、アバター、プロフィール URL

settings

統合された設定のキー/値マップ

server

単一呼び出しサマリー: ホスト名、稼働時間、Unraid バージョン、アレイ状態

servers

LAN/WAN IP および URL を持つすべての登録済みサーバー

flash

フラッシュドライブのベンダーおよび製品情報

ups_devices

バッテリーおよび電力メトリクスを持つすべての UPS デバイス

ups_device

単一の UPS デバイスの詳細

device_id

ups_config

UPS デーモンの設定

health — 4 個のサブアクション

接続およびシステム健全性診断。

サブアクション

説明

必須パラメータ

check

包括的な健全性: API レイテンシ、アレイ状態、アラート、Docker コンテナサマリー

test_connection

Unraid API に ping を送信し、レイテンシを ms で返す

diagnose

サブスクリプションシステムのステータス、エラー数、再接続状態

setup

インタラクティブな資格情報設定 (MCP の引き出しをサポート)

array — 13 個のサブアクション

パリティチェックおよびアレイディスク操作。破壊的サブアクションには * が付いています。

サブアクション

説明

必須パラメータ

破壊的

parity_status

現在のパリティチェックの進捗、速度、エラー

parity_history

過去のパリティチェック結果

parity_start

パリティチェックを開始する

correct (bool)

parity_pause

実行中のパリティチェックを一時停止する

parity_resume

一時停止中のパリティチェックを再開する

parity_cancel

実行中のパリティチェックをキャンセルする

start_array

Unraid アレイを開始する

stop_array

Unraid アレイを停止する

confirm=True

*

add_disk

アレイにディスクを追加する

disk_id; オプション slot

remove_disk

アレイからディスクを削除する (アレイは停止している必要がある)

disk_id, confirm=True

*

mount_disk

アレイディスクをマウントする

disk_id

unmount_disk

アレイディスクをアンマウントする

disk_id

clear_disk_stats

ディスクの I/O 統計をクリアする (元に戻せません)

disk_id, confirm=True

*

disk — 6 個のサブアクション

共有、物理ディスク、ログファイル、およびフラッシュバックアップ。破壊的サブアクションには * が付いています。

サブアクション

説明

必須パラメータ

破壊的

shares

サイズ、割り当て設定、LUKS 状態を持つすべてのユーザー共有

disks

物理ディスクリスト (ID、デバイス、名前)

disk_details

単一ディスク: シリアル、サイズ、温度

disk_id

log_files

利用可能なログファイルリスト (名前、パス、サイズ、変更日時)

logs

行範囲を指定してログファイルの内容を読み取る

log_path; オプション tail_lines (デフォルト 100, 最大 10000)

flash_backup

フラッシュドライブからリモートへの rclone バックアップを開始する

remote_name, source_path ( /boot で始まる必要がある), destination_path, confirm=True

*

flash_backup の詳細: Unraid の initiateFlashBackup GraphQL ミューテーションを呼び出し、フラッシュドライブから設定済みの rclone リモートへの rclone コピーをトリガーします。リモート上の宛先が存在する場合は上書きされます。{ status, jobId } を返します。復元するには、rclone を使用してバックアップをフラッシュドライブにコピーし直すか、個別の設定ファイルを抽出します。事前に rclone/create_remote を介して rclone リモートを設定してください。

docker — 7 個のサブアクション

コンテナのライフサイクルとネットワーク検査。破壊的サブアクションはありません。

サブアクション

説明

必須パラメータ

list

すべてのコンテナ: ID、名前、イメージ、状態、ステータス、autoStart

details

コンテナの詳細: ポート、マウント、ラベル、ネットワーク設定

container_id

start

コンテナを開始する

container_id

stop

コンテナを停止する

container_id

restart

コンテナを再起動する (停止してから開始)

container_id

networks

すべての Docker ネットワーク: ID、名前、ドライバー、スコープ

network_details

IPv6、コンテナ、オプション、ラベルを持つ単一ネットワーク

network_id

コンテナ識別子は、完全な ID、短い ID プレフィックス、正確な名前、または曖昧さのない名前プレフィックスを受け入れます。ミューテーション (start, stop, restart) には、正確な名前または完全な ID が必要です。

vm — 9 個のサブアクション

仮想マシンのライフサイクル。破壊的サブアクションには * が付いています。

サブアクション

説明

必須パラメータ

破壊的

list

すべての VM: ID、名前、状態、UUID

details

単一 VM の詳細

vm_id

start

VM を開始する

vm_id

stop

VM を正常に停止する

vm_id

pause

実行中の VM を一時停止する

vm_id

resume

一時停止中の VM を再開する

vm_id

reboot

VM を再起動する

vm_id

force_stop

VM を強制終了する (データ損失の可能性あり)

vm_id, confirm=True

*

reset

正常なシャットダウンなしで VM をハードリセットする

vm_id, confirm=True

*

vm_id は UUID、プレフィックス付き ID、または VM 名を受け入れます。

notification — 12 個のサブアクション

システム通知の CRUD。破壊的サブアクションには * が付いています。

サブアクション

説明

必須パラメータ

破壊的

overview

重要度別の未読およびアーカイブ数 (INFO/WARNING/ALERT)

list

ページ分割された通知リスト

list_type (UNREAD または ARCHIVE, デフォルト UNREAD); オプション importance, offset, limit

create

通知を作成する

title (≤200), subject (≤500), description (≤2000), importance (INFO/WARNING/ALERT)

archive

単一の通知をアーカイブする

notification_id

mark_unread

アーカイブされた通知を未読に戻す

notification_id

recalculate

概要のカウントを再計算する

archive_all

すべての未読通知をアーカイブする

オプション importance でフィルタリング

archive_many

ID で特定の通知をアーカイブする

notification_ids (リスト)

unarchive_many

ID で特定の通知をアーカイブ解除する

notification_ids (リスト)

unarchive_all

すべてのアーカイブ済み通知を未読に戻す

オプション importance でフィルタリング

delete

単一の通知を完全に削除する

notification_id, notification_type, confirm=True

*

delete_archived

すべてのアーカイブ済み通知を完全に削除する

confirm=True

*

key — 7 個のサブアクション

API キー管理。破壊的サブアクションには * が付いています。

サブアクション

説明

必須パラメータ

破壊的

list

ロールと権限を持つすべての API キー

get

単一の API キーの詳細

key_id

create

API キーを作成する

name; オプション roles, permissions

update

名前、ロール、または権限を更新する

key_id; オプション name, roles, permissions

delete

API キーを削除する (即座にアクセスを取り消す)

key_id, confirm=True

*

add_role

既存のキーにロールを追加する

key_id, roles (最初の要素を使用)

remove_role

既存のキーからロールを削除する

key_id, roles (最初の要素を使用)

plugin — 3 個のサブアクション

Unraid プラグイン管理。破壊的サブアクションには * が付いています。

サブアクション

説明

必須パラメータ

破壊的

list

バージョンとモジュールフラグを持つすべてのインストール済みプラグイン

add

名前でプラグインをインストールする

names (リスト); オプション bundled, restart

remove

名前でプラグインをアンインストールする (再インストールなしでは元に戻せません)

names (リスト), confirm=True

*

rclone — 4 個のサブアクション

クラウドストレージリモート管理。破壊的サブアクションには * が付いています。

サブアクション

説明

必須パラメータ

破壊的

list_remotes

タイプとパラメータを持つすべての設定済み rclone リモート

config_form

プロバイダータイプの設定フォームスキーマ

オプション provider_type

create_remote

新しい rclone リモートを作成する

name, provider_type, config_data (文字列/数値/ブールの辞書; 最大 50 キー)

delete_remote

rclone リモート設定を削除する (リモートデータは削除しません)

name, confirm=True

*

setting — 2 個のサブアクション

システム設定。破壊的サブアクションには * が付いています。

サブアクション

説明

必須パラメータ

破壊的

update

システム設定を更新する (JSON キー/値入力)

settings_input (辞書; 最大 100 キー、スカラー値のみ)

configure_ups

UPS 監視設定を上書きする

ups_config (辞書), confirm=True

*

customization — 5 個のサブアクション

UI テーマおよび SSO 状態。

サブアクション

説明

必須パラメータ

theme

完全なテーマ、パートナー情報、およびアクティベーションコード

public_theme

公開向けテーマおよびパートナー情報 (未認証ビュー)

is_initial_setup

初期設定ウィザードが完了しているかどうか

sso_enabled

SSO が有効かどうか

set_theme

アクティブな UI テーマを設定する

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    F
    maintenance
    Provides read-only server monitoring and diagnostic tools for AI assistants to manage Linux and Unraid systems via SSH. It enables natural language interactions for container management, storage health checks, and system log analysis while keeping credentials secure.
    17
    ISC
  • A
    license
    A
    quality
    D
    maintenance
    A code-mode MCP server for the Unraid 7.2+ GraphQL API that exposes search and execute tools, allowing LLM agents to introspect and call any GraphQL field via sandboxed JavaScript.
    2
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that enables AI assistants like Claude to manage Unraid servers through natural language. Install it from Community Applications and control your homelab from any MCP-compatible AI client.
    2
    MIT