适合谁
- Unraid 用户希望使用 AI 助手管理家庭实验室
- 希望通过 MCP 协议将 Unraid 集成到 Claude Code、Codex 等工具中的开发者
U
48FMRS · D
社区维护的 MCP 服务器，用于管理 Unraid，提供丰富的工具，但需注意权限和风险。
Unraid MCP 服务器 (unraid-mcp) 通过 MCP 工具与 Unraid 的 GraphQL API 交互，提供系统信息、Docker 容器、虚拟机、阵列/校验、通知、插件、远程同步等能力。
工具能力
unraid_query
用于查询 Unraid 服务器状态并执行管理操作的通用工具
安装接入
使用 uvx 运行：uvx unraid-mcp，并设置环境变量 UNRAID_API_URL 和 UNRAID_API_KEY。
选型与风险
不适合谁
- 需要官方支持的用户（此服务器由社区维护）
- 需要图形界面的用户
所需权限
- 需要 UNRAID_API_URL（必填）
- 需要 UNRAID_API_KEY（必填，敏感）
风险与副作用
- 需要提供 API 密钥，可能暴露服务器访问权限
- 某些操作（如阵列启停）可能影响数据可用性
常见排障
- 检查 UNRAID_API_URL 是否正确（例如 http://192.168.1.100）
- 确认 UNRAID_API_KEY 是否有效
- 确保服务器网络可达
- 若使用自签名证书，可能需要跳过 TLS 验证（未在 Python 版本中明确，但可通过环境变量）
使用场景
监控 Unraid 系统状态（阵列、磁盘、CPU）
管理 Docker 容器和虚拟机
查看和发送通知
支持客户端
Claude Desktop完整支持