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 伺服器(單一靜態二進位檔,crate unraid-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 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/dinglebear-aiunraid.svg)](https://yunodb.com/tools/dinglebear-aiunraid?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/dinglebear-aiunraid?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/dinglebear-aiunraid.svg" alt="Featured on YunoDB" height="20"></a>