Unraid MCP Server
Unraid MCP
GraphQL ベースの Unraid 用 MCP サーバー。システム検査、管理操作、ライブテレメトリ、および明示的な確認が必要な破壊的アクションのための統合された unraid ツールを提供します。
概要
このサーバーは、MCP ツール呼び出しを HTTP および WebSocket 経由の Unraid GraphQL クエリとミューテーションに変換します。すべての操作は、action + subaction によってルーティングされる単一の unraid ツールを共有します。ライブテレメトリは、Unraid API からリアルタイムデータをストリーミングする WebSocket サブスクリプションを使用します。
Related MCP server: unraid-mcp-server
このリポジトリの内容
unraid_mcp/— サーバー、GraphQL クライアント、WebSocket サブスクリプション、設定、およびツールハンドラーskills/unraid/— クライアント向けスキルドキュメントdocs/— 認証、破壊的アクション、および公開に関するリファレンス.claude-plugin/,.codex-plugin/,gemini-extension.json— クライアントマニフェストdocker-compose.yaml,Dockerfile,entrypoint.sh— コンテナデプロイメントtests/— ユニットテスト、安全性テスト、スキーマテスト、HTTP レイヤーテスト、およびライブカバレッジテスト
ツール
ツール一覧
ツール | 目的 |
| すべての操作のための統合されたアクション/サブアクションルーター |
| このリファレンスを Markdown で返す |
| WebSocket サブスクリプションシステムの完全な診断ダンプ |
| スキーマ/デバッグ作業のために生の GraphQL サブスクリプションをプローブする |
unraid — アクショングループ
すべての操作は 1 つのツールを経由します。action を選択し、その中の subaction を選択してください。
system — 18 個のサブアクション
サーバー情報、メトリクス、ネットワーク、および UPS。
サブアクション | 説明 | 必須パラメータ |
| OS、CPU、メモリレイアウト、バージョン、マシン ID | — |
| アレイの状態、容量、ディスク健全性サマリー | — |
| アクセス URL、HTTP/HTTPS ポート、LAN/WAN IP | — |
| ライセンスタイプ、キーファイル、有効期限 | — |
| Unraid 変数セット全体 (タイムゾーン、共有など) | — |
| ライブ CPU % およびメモリ使用量 | — |
| 実行中のサービス (名前、オンライン状態、バージョン) | — |
| 現在の UI テーマ名 | — |
| 設定の妥当性とエラー状態 | — |
| 到達可能性のブール値チェック | — |
| オーナーのユーザー名、アバター、プロフィール URL | — |
| 統合された設定のキー/値マップ | — |
| 単一呼び出しサマリー: ホスト名、稼働時間、Unraid バージョン、アレイ状態 | — |
| LAN/WAN IP および URL を持つすべての登録済みサーバー | — |
| フラッシュドライブのベンダーおよび製品情報 | — |
| バッテリーおよび電力メトリクスを持つすべての UPS デバイス | — |
| 単一の UPS デバイスの詳細 |
|
| UPS デーモンの設定 | — |
health — 4 個のサブアクション
接続およびシステム健全性診断。
サブアクション | 説明 | 必須パラメータ |
| 包括的な健全性: API レイテンシ、アレイ状態、アラート、Docker コンテナサマリー | — |
| Unraid API に ping を送信し、レイテンシを ms で返す | — |
| サブスクリプションシステムのステータス、エラー数、再接続状態 | — |
| インタラクティブな資格情報設定 (MCP の引き出しをサポート) | — |
array — 13 個のサブアクション
パリティチェックおよびアレイディスク操作。破壊的サブアクションには * が付いています。
サブアクション | 説明 | 必須パラメータ | 破壊的 |
| 現在のパリティチェックの進捗、速度、エラー | — | — |
| 過去のパリティチェック結果 | — | — |
| パリティチェックを開始する |
| — |
| 実行中のパリティチェックを一時停止する | — | — |
| 一時停止中のパリティチェックを再開する | — | — |
| 実行中のパリティチェックをキャンセルする | — | — |
| Unraid アレイを開始する | — | — |
| Unraid アレイを停止する |
| * |
| アレイにディスクを追加する |
| — |
| アレイからディスクを削除する (アレイは停止している必要がある) |
| * |
| アレイディスクをマウントする |
| — |
| アレイディスクをアンマウントする |
| — |
| ディスクの I/O 統計をクリアする (元に戻せません) |
| * |
disk — 6 個のサブアクション
共有、物理ディスク、ログファイル、およびフラッシュバックアップ。破壊的サブアクションには * が付いています。
サブアクション | 説明 | 必須パラメータ | 破壊的 |
| サイズ、割り当て設定、LUKS 状態を持つすべてのユーザー共有 | — | — |
| 物理ディスクリスト (ID、デバイス、名前) | — | — |
| 単一ディスク: シリアル、サイズ、温度 |
| — |
| 利用可能なログファイルリスト (名前、パス、サイズ、変更日時) | — | — |
| 行範囲を指定してログファイルの内容を読み取る |
| — |
| フラッシュドライブからリモートへの rclone バックアップを開始する |
| * |
flash_backup の詳細: Unraid の initiateFlashBackup GraphQL ミューテーションを呼び出し、フラッシュドライブから設定済みの rclone リモートへの rclone コピーをトリガーします。リモート上の宛先が存在する場合は上書きされます。{ status, jobId } を返します。復元するには、rclone を使用してバックアップをフラッシュドライブにコピーし直すか、個別の設定ファイルを抽出します。事前に rclone/create_remote を介して rclone リモートを設定してください。
docker — 7 個のサブアクション
コンテナのライフサイクルとネットワーク検査。破壊的サブアクションはありません。
サブアクション | 説明 | 必須パラメータ |
| すべてのコンテナ: ID、名前、イメージ、状態、ステータス、autoStart | |
| コンテナの詳細: ポート、マウント、ラベル、ネットワーク設定 |
|
| コンテナを開始する |
|
| コンテナを停止する |
|
| コンテナを再起動する (停止してから開始) |
|
| すべての Docker ネットワーク: ID、名前、ドライバー、スコープ | — |
| IPv6、コンテナ、オプション、ラベルを持つ単一ネットワーク |
|
コンテナ識別子は、完全な ID、短い ID プレフィックス、正確な名前、または曖昧さのない名前プレフィックスを受け入れます。ミューテーション (start, stop, restart) には、正確な名前または完全な ID が必要です。
vm — 9 個のサブアクション
仮想マシンのライフサイクル。破壊的サブアクションには * が付いています。
サブアクション | 説明 | 必須パラメータ | 破壊的 |
| すべての VM: ID、名前、状態、UUID | — | — |
| 単一 VM の詳細 |
| — |
| VM を開始する |
| — |
| VM を正常に停止する |
| — |
| 実行中の VM を一時停止する |
| — |
| 一時停止中の VM を再開する |
| — |
| VM を再起動する |
| — |
| VM を強制終了する (データ損失の可能性あり) |
| * |
| 正常なシャットダウンなしで VM をハードリセットする |
| * |
vm_id は UUID、プレフィックス付き ID、または VM 名を受け入れます。
notification — 12 個のサブアクション
システム通知の CRUD。破壊的サブアクションには * が付いています。
サブアクション | 説明 | 必須パラメータ | 破壊的 |
| 重要度別の未読およびアーカイブ数 (INFO/WARNING/ALERT) | — | — |
| ページ分割された通知リスト |
| — |
| 通知を作成する |
| — |
| 単一の通知をアーカイブする |
| — |
| アーカイブされた通知を未読に戻す |
| — |
| 概要のカウントを再計算する | — | — |
| すべての未読通知をアーカイブする | オプション | — |
| ID で特定の通知をアーカイブする |
| — |
| ID で特定の通知をアーカイブ解除する |
| — |
| すべてのアーカイブ済み通知を未読に戻す | オプション | — |
| 単一の通知を完全に削除する |
| * |
| すべてのアーカイブ済み通知を完全に削除する |
| * |
key — 7 個のサブアクション
API キー管理。破壊的サブアクションには * が付いています。
サブアクション | 説明 | 必須パラメータ | 破壊的 |
| ロールと権限を持つすべての API キー | — | — |
| 単一の API キーの詳細 |
| — |
| API キーを作成する |
| — |
| 名前、ロール、または権限を更新する |
| — |
| API キーを削除する (即座にアクセスを取り消す) |
| * |
| 既存のキーにロールを追加する |
| — |
| 既存のキーからロールを削除する |
| — |
plugin — 3 個のサブアクション
Unraid プラグイン管理。破壊的サブアクションには * が付いています。
サブアクション | 説明 | 必須パラメータ | 破壊的 |
| バージョンとモジュールフラグを持つすべてのインストール済みプラグイン | — | — |
| 名前でプラグインをインストールする |
| — |
| 名前でプラグインをアンインストールする (再インストールなしでは元に戻せません) |
| * |
rclone — 4 個のサブアクション
クラウドストレージリモート管理。破壊的サブアクションには * が付いています。
サブアクション | 説明 | 必須パラメータ | 破壊的 |
| タイプとパラメータを持つすべての設定済み rclone リモート | — | — |
| プロバイダータイプの設定フォームスキーマ | オプション | — |
| 新しい rclone リモートを作成する |
| — |
| rclone リモート設定を削除する (リモートデータは削除しません) |
| * |
setting — 2 個のサブアクション
システム設定。破壊的サブアクションには * が付いています。
サブアクション | 説明 | 必須パラメータ | 破壊的 |
| システム設定を更新する (JSON キー/値入力) |
| — |
| UPS 監視設定を上書きする |
| * |
customization — 5 個のサブアクション
UI テーマおよび SSO 状態。
サブアクション | 説明 | 必須パラメータ |
| 完全なテーマ、パートナー情報、およびアクティベーションコード | — |
| 公開向けテーマおよびパートナー情報 (未認証ビュー) | — |
| 初期設定ウィザードが完了しているかどうか | — |
| SSO が有効かどうか | — |
| アクティブな UI テーマを設定する |
This server cannot be deployed
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
Connect AI assistants to your GitHub-hosted Obsidian vault to seamlessly access, search, and analy…
Official Fibery MCP server: query and update your workspace from any AI client via OAuth.
Related MCP Servers
- AlicenseAqualityCmaintenanceA 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.21MIT
- FlicenseNot gradedqualityBmaintenanceEnables AI assistants to manage Unraid OS via Docker, system calls, and file system access for automating array, share, and container operations.-
- AlicenseNot gradedqualityDmaintenanceAn 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.3MIT
- AlicenseBqualityBmaintenanceA Model Context Protocol server that enables AI clients to inspect and manage an Unraid server via its GraphQL API, with read-only defaults and optional enabled mutations.88MIT