unraid
透過 MCP 工具經由 GraphQL API 查詢、監控及管理 Unraid 伺服器。支援系統資訊、Docker、虛擬機器、陣列/同位檢查、通知、外掛程式、rclone 及即時遙測。
unraid 是什麼?
透過 MCP 工具經由 GraphQL API 查詢、監控及管理 Unraid 伺服器。支援系統資訊、Docker、虛擬機器、陣列/同位檢查、通知、外掛程式、rclone 及即時遙測。
unraid 概覽
這是什麼
Unraid 是一個針對 Unraid 伺服器的工具集合,包含兩個 MCP 伺服器(Python 和 Rust)以及三個 Unraid OS 外掛程式,還有 Claude/Codex 代理整合。它透過 GraphQL API 和 MCP 工具來查詢、監控和管理 Unraid 伺服器。此儲存庫已於 2026 年 7 月 27 日從 unraid-mcp 重新命名為 unraid,原本獨立的 runraid 和 incus-unraid 儲存庫也已合併至此。PyPI 套件、容器映像、Claude 外掛程式和 Unraid .plg 檔案仍命名為 unraid-mcp。
主要功能
- 透過 GraphQL API 支援系統資訊、Docker、虛擬機器、陣列/同位元檢查、通知、外掛程式、rclone 和即時遙測。
- 兩個 MCP 伺服器:Python 伺服器(旗艦版,以
unraid-mcp發布至 PyPI)和 Rust 伺服器(單一靜態二進位檔,crateunraid-rmcp在 crates.io 上,另有 npm 啟動器@dinglebear/unraid)。 - 三個 Unraid OS 外掛程式:MCP 外掛程式(搭載 Rust 伺服器)、Incus 外掛程式(執行與 LAN 隔離的 Incus 系統容器,附 NestJS/GraphQL 後端)和 Codex 外掛程式(嵌入 Codex 聊天頭應用伺服器)。
- 為 Claude Code 和 Codex 提供的代理外掛程式,無需手動設定憑證:設定會透過
${user_config.*}直接映射到伺服器環境中。 - Rust 伺服器同時提供查詢和變更操作;讀取操作需要
unraid:read權限,變更操作需要unraid:admin權限。 - Rust MCP 支援投影模式:
legacy(預設)、atomic或both。
使用情境
- 查詢和監控 Unraid 伺服器的系統資訊、Docker 容器、虛擬機器、陣列/同位元檢查狀態、通知、外掛程式和 rclone 操作。
- 透過 MCP 工具以程式化方式管理 Unraid 伺服器,包括虛擬機器和 Docker 生命週期、陣列啟動/停止以及通知寫入。
- 在 Unraid 主機上執行與 LAN 隔離的 Incus 系統容器(開發容器)。
- 在 Unraid 伺服器上嵌入 Codex 聊天頭應用伺服器。
快速開始
Python MCP 伺服器(旗艦版)的完整文件請參閱 unraid-py/README.md 和 unraid-py/docs/。可使用 uvx unraid-mcp 啟動。Rust MCP 伺服器 + CLI:bashcargo install --path unraid-rs --locked # 從儲存庫根目錄執行# 在查詢前私下設定 UNRAID_API_URL 和 UNRAID_API_KEY。runraid setup check # 檢查設定而不修復檔案runraid array # 讀取陣列狀態runraid serve mcp # MCP HTTP(預設 :40010;設定驗證)代理外掛程式安裝(一個 marketplace 指令,兩個清單):text/plugin marketplace add dinglebear-ai/unraid/plugin install unraid-mcp@unraid-mcp # Python 伺服器/plugin install runraid@unraid-mcp # Rust 伺服器
授權與價格
授權:MIT。價格:開源(未說明)。
內容整理自該專案公開的 README 與儲存庫資訊。