← 返回目录
U

Unraid MCP

社区
通过 GraphQL 查询、监控和管理 Unraid 服务器
分类
开发工具 第 280 / 438
Stars
★ 136 非常热门
传输方式
stdio(本地进程)
运行环境
Python
凭据
需要 API Key / 凭据
许可证
MIT
最近提交
工具数
1
48FMRS · D

社区维护的 MCP 服务器,用于管理 Unraid,提供丰富的工具,但需注意权限和风险。

最强项 · 维护活跃度 11/20 最弱项 · 可靠性 8/20

可靠性
8/20
安全与权限
10/20
维护活跃度
11/20
文档质量
9/20
安装易用性
10/20
查看各项评分依据
可靠性 8/20
清单结构合理,明确提供了 uvx 运行方式和两个必需环境变量;README 声称有 pytest 与 CI 测试,但这些并未提供实际文件,无法验证服务器能否干净启动、初始化握手成功或工具行为是否与声明一致。由于缺少可验证的执行证据,且存在 13 个开放问题,故按保守原则给 8 分。
安全与权限 10/20
UNRAID_API_KEY 在清单中正确标记为必需且敏感,这是可取之处。但服务器很可能具有变更操作(管理功能),而所提供资料中未说明危险操作的确认机制或权限边界;README 中关于 unraid:read/unraid:admin 作用域的说明属于 Rust 服务器,不能归因于本 Python 服务器。未发现恶意行为或硬编码密钥,未触发红线,但因缺少变更确认的证据,综合给 10 分。
维护活跃度 11/20
仓库未归档,使用 MIT 许可证,README 提到 release-please 管理版本和 CI 测试,且版本号 2.10.1 显示持续发布。但未提供提交历史、问题响应时间或依赖更新记录,仅有开放问题 13 个这一信息。在保守静态审查下,给 11 分。
文档质量 9/20
顶层 README 对仓库结构、发布机制和插件安装说明较详实,但本服务器的完整文档——工具参数、故障排除、限制、成本等——指向 unraid-py/README.md 和 docs/,而这两处内容并未提供。此外,README 中的 mcp-name 注释(tv.tootie/unraid-mcp)与清单中的 ai.dinglebear/unraid-mcp 不一致,产生混淆。故评 9 分。
安装易用性 10/20
通过 uvx unraid-mcp 启动路径清晰,两个必需环境变量已在清单中列出,基本安装较简单。但缺少主流客户端(Claude、Codex、Gemini)的具体配置示例,这些示例位于未提供的文档中。同时按静态校准,未提供可验证的 CI 与测试证据,setup 最高不超过 15 分;综合考虑给 10 分。

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

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

  • Unraid 用户希望使用 AI 助手管理家庭实验室
  • 希望通过 MCP 协议将 Unraid 集成到 Claude Code、Codex 等工具中的开发者

不适合谁

  • 需要官方支持的用户(此服务器由社区维护)
  • 需要图形界面的用户

所需权限

  • 需要 UNRAID_API_URL(必填)
  • 需要 UNRAID_API_KEY(必填,敏感)

风险与副作用

  • 需要提供 API 密钥,可能暴露服务器访问权限
  • 某些操作(如阵列启停)可能影响数据可用性

安装接入

准备工作

运行环境:Python

UNRAID_API_URL 必填 Unraid 服务器的基础 URL(如 http://192.168.1.100),由用户自己的服务器地址提供,必填。
UNRAID_API_KEY 必填密钥 Unraid API 密钥,用于 GraphQL API 认证,需在 Unraid 服务器上生成,必填且为机密。

使用 uvx 运行:uvx unraid-mcp,并设置环境变量 UNRAID_API_URL 和 UNRAID_API_KEY。

验证是否装好

在客户端工具列表中应出现 unraid_query 工具;让 AI 查询服务器系统信息,若返回真实的 Unraid 主机数据即说明连接成功。

常见排障

  1. 检查 UNRAID_API_URL 是否正确(例如 http://192.168.1.100)
  2. 确认 UNRAID_API_KEY 是否有效
  3. 确保服务器网络可达
  4. 若使用自签名证书,可能需要跳过 TLS 验证(未在 Python 版本中明确,但可通过环境变量)

试试这样问

连接成功后,可以直接对 AI 助手这样说:

  • 查看我的 Unraid 服务器的系统信息和 CPU/内存遥测数据
  • 列出服务器上正在运行的所有 Docker 容器及其状态
  • 检查阵列状态和奇偶校验进度
  • 查询当前未读的通知和已安装的插件列表

工具能力 1

unraid_query 只读
用于查询 Unraid 服务器状态并执行管理操作的通用工具

使用场景

监控 Unraid 系统状态(阵列、磁盘、CPU)
管理 Docker 容器和虚拟机
查看和发送通知

支持客户端

Claude Desktop

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

详细介绍

Unraid MCP 服务器 (unraid-mcp) 通过 MCP 工具与 Unraid 的 GraphQL API 交互,提供系统信息、Docker 容器、虚拟机、阵列/校验、通知、插件、远程同步等能力。

同类可选方案

Context7 80 · B

Upstash 官方维护,为 AI 编码助手提供实时更新的第三方库文档

★ 62.9k · 工具数 2 与当前对比 →

同仓库的其他 Server

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