← 返回目录

Unraid

社区

Unraid RMCP - 用于 Unraid GraphQL 操作的 Rust MCP 服务器和 CLI

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 云存储第 15 / 15
Stars: ★ 137 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js · Rust
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 11 天前

31FMRS · D

这是一个社区维护的 Rust MCP 服务器，用于管理 Unraid。它提供丰富的工具但非官方，需要谨慎配置权限。

最强项 · 文档质量 8/20 最弱项 · 可靠性 4/20

可靠性

4/20

安全与权限

6/20

维护活跃度

6/20

文档质量

8/20

安装易用性

7/20

查看各项评分依据

可靠性 4/20: 清单格式完整，环境变量与 npx 入口清晰，但本次仅提供清单和 README，无源码、测试或 CI 证据；README 中的构建/测试命令不可验证。无法确认 MCP 初始化握手、工具列表与真实行为一致，错误处理与边界情况证据不足，故保守扣分。
安全与权限 6/20: UNRAID_API_KEY 在清单中标记为 secret，README 也区分了 unraid:read 与 unraid:admin 权限，这是正面证据。但 npm 包装器会在运行时从 GitHub 下载预编译二进制，且未提及校验和验证；VM/Docker 生命周期、数组启停等危险操作仅有 admin 权限门控，未说明逐操作确认机制。数据流和 OAuth 细节未完整披露，故不能给高分。
维护活跃度 6/20: 仓库未归档，MIT 许可证存在，版本为 0.4.2，README 声称 release-please 管理 unraid-rs 并使用 unraid-rs-vX.Y.Z 标签。但未提供提交历史、议题响应、依赖更新或安全响应渠道的证据；星标和议题数仅作发现信号，不参与计分。治理与持续维护证据不足，故保守评分。
文档质量 8/20: README 提供了快速开始、环境变量表、CLI 示例、认证模式和权限说明，并说明 OAuth 变量在 CLAUDE.md 中（但该文件未提供）。缺少分工具参数文档、限制说明和故障排查章节，存在隐藏假设，故评分在可用但有缺口的位置。
安装易用性 7/20: npm 包 + npx 命令加必需环境变量的路径可行，也给出了插件市场安装命令。但未提供主流客户端的具体配置 JSON 示例，运行时需从 GitHub 下载二进制，依赖网络且较脆弱；静态校准要求有可验证执行证据才能给 15 分以上，本审查无此类证据，故保守给分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

熟悉 Rust 的开发者
需要在本地通过 CLI 或 MCP 管理 Unraid 的用户
希望使用单一静态二进制文件的用户

不适合谁

需要官方支持的 Unraid 用户
希望使用 Python 生态的用户
需要图形界面管理的用户

所需权限

需要 Unraid API URL 和 API 密钥
读取操作需要 `unraid:read` 权限
变更操作需要 `unraid:admin` 权限

风险与副作用

并非官方 Unraid 工具，可能不受支持
需要网络访问 Unraid 服务器
API 密钥泄露可能造成安全风险
写操作可能影响虚拟机、Docker 或阵列状态

安装接入

准备工作

运行环境：Node.js · Rust

UNRAID_API_URL 必填 Unraid 服务器的 GraphQL 端点完整 URL，例如 https://unraid.example.com/graphql。

UNRAID_API_KEY 必填密钥 Unraid API 密钥，在 Unraid 服务器的 API 设置中生成。

UNRAID_RMCP_TOKEN 可选密钥可选，访问 /mcp 端点的静态 bearer 令牌。

其他可选配置项（8 个）

UNRAID_RMCP_VERSION 可选可选，覆盖下载的 Unraid RMCP 二进制对应的 GitHub release 标签，如 v0.2.2。

UNRAID_RMCP_REPO 可选可选，覆盖 release 资产下载的 GitHub owner/repo，默认 dinglebear-ai/unraid-mcp。

UNRAID_RMCP_RELEASE_BASE_URL 可选可选，覆盖 release 下载的基础 URL。

RUST_LOG 可选可选，日志追踪过滤器，默认 info。

UNRAID_API_SKIP_TLS_VERIFY 可选可选，设为 true 时接受 Unraid 的自签名证书，默认 false。

UNRAID_RMCP_HOST 可选可选，MCP HTTP 服务绑定主机，默认 0.0.0.0。

UNRAID_RMCP_PORT 可选可选，MCP HTTP 服务绑定端口，默认 40010。

UNRAID_RMCP_AUTH_MODE 可选可选，认证模式，bearer（默认）或 oauth。

通过 npm 安装：npx @dinglebear/unraid mcp。需要设置环境变量 UNRAID_API_URL 和 UNRAID_API_KEY。也可从源码构建：cd unraid-rs && cargo build --release，然后运行 runraid serve mcp。

验证是否装好

启动后让客户端查询系统信息或阵列状态；若能返回 Unraid 服务器的实际数据，说明 UNRAID_API_URL 和 UNRAID_API_KEY 配置正确、连接成功。

常见排障

检查 `UNRAID_API_URL` 和 `UNRAID_API_KEY` 是否正确
确保网络能访问 Unraid 服务器
查看日志：设置 `RUST_LOG=debug`
验证 SSL 证书或设置 `UNRAID_API_SKIP_TLS_VERIFY=true`

试试这样问

连接成功后，可以直接对 AI 助手这样说：

查看我的 Unraid 服务器的系统信息和运行状态
列出所有正在运行的 Docker 容器
显示当前阵列和奇偶校验（parity）状态
检查有没有未读的 Unraid 通知

使用场景

查询 Unraid 系统状态

管理 Docker 容器和虚拟机

监控阵列和奇偶校验

查看和操作通知

管理插件和 rclone

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

一个 Rust 实现的 MCP 服务器，通过 GraphQL API 查询、监控和管理 Unraid 服务器。支持系统信息、Docker、虚拟机、阵列/奇偶校验、通知、插件、rclone 和实时遥测。

同仓库的其他 Server

源版本 6d00e73cd7dd 数据同步于 2026-10-12 查看 FMRS 评分方法