用途:对 UniFi 网络执行健康检查,诊断设备状态、连接问题、固件更新与系统健康状况,适用于被要求检查网络健康时。
主要能力:用 unifi_batch 一次性并行获取所需数据,替代逐个顺序调用;首次采集使用 unifi_batch(operations=[{ "tool": "unifi_get_system_info" }, { "tool": "unifi_get_network_health" }, { "tool": "unifi_list_devices" }, { "tool": "unifi_list_alarms" }])。如需设备或告警细节,可追加 unifi_batch(operations=[{ "tool": "unifi_list_clients" }, { "tool": "unifi_get_top_clients" }])。分析时参考 references/device-states.md(设备状态码含义)、references/alarm-types.md(告警类型、严重级别与处置)、references/health-subsystems.md(WAN、LAN、WLAN、VPN 子系统健康字段,诊断优先级 WAN → LAN → WLAN → VPN)。报告结构含整体状态、控制器版本与运行时间、设备在线/总数、固件更新、活动告警与建议。
使用方式:先确认 MCP 服务器已配置,用 unifi_tool_index 确认可用工具;若未列出 UniFi 工具则说明服务器未连接。必需读取失败时停止并引导用户使用 unifi-network-setup 技能。禁止索要密钥。
限制:报告必须含覆盖范围与限制,注明各来源状态(可用、不可用、部分或封顶)、时间窗口与时区、过滤器、返回计数、分页与失败调用;成功空查询是观察结果,失败或缺失来源为不可用,不得当作空结果。数据不可用、部分或封顶时不得声称完整覆盖、全部正常或整体健康。需区分观察、假设与身份,时间、名称相似或缺少匹配事件不能证明身份或因果。具体收费、平台等信息暂未提供。