用途
该技能为 UniFi 网络控制器提供一组系统管理与监控工具，覆盖站点管理、多站点聚合、备份、QoS 与流量路由、流量流分析、流量匹配列表、DPI（深度包检测）统计，以及 RADIUS 和访客门户配置。适合通过工具调用查看网络状态、排查带宽异常、执行备份与恢复、配置认证与访客接入等运维任务。
主要能力
站点管理
- list_sites：列出控制器管理的所有站点
- get_site_details：获取站点的配置与详情
- get_site_statistics：获取站点的流量与设备数量
多站点聚合（Site Manager）
需要云 API 或 Site Manager 访问权限。
- list_all_sites_aggregated：汇总所有站点的状态
- get_site_health_summary：获取一个或全部站点的健康评分
- get_site_inventory：按站点汇总设备清单
- compare_site_performance：对比多个站点的性能指标
- get_cross_site_statistics：跨站点带宽与使用情况
- search_across_sites：在所有站点中搜索客户端或设备
- get_internet_health：互联网健康评分与指标
- get_isp_metrics、query_isp_metrics：获取或查询站点的 ISP 性能指标及其历史数据
- list_hosts、get_host：列出组织内主机、获取指定主机详情
- list_sdwan_configs、get_sdwan_config、get_sdwan_config_status：列出或获取 SD-WAN 配置及其部署状态
- list_vantage_points：列出 ISP 观测点
- get_version_control：获取固件版本控制策略
备份
- list_backups、get_backup_details、get_backup_status：列出备份、查看元数据与操作状态
- get_backup_schedule、schedule_backups：查看或配置自动备份计划
- trigger_backup：立即开始备份
- download_backup：下载备份文件
- validate_backup：校验备份文件完整性
- restore_backup：从备份恢复（需 confirm=True）
- delete_backup：删除备份（需 confirm=True）
- get_restore_status：查看恢复操作状态
QoS 与流量路由
- list_traffic_routes：列出 UniFi 流量路由（基于策略的路由，例如让客户端或域名走 VPN）；仅本地 API
- get_smart_queue_status：查看 Smart Queue 配置与状态
- configure_smart_queue：配置 Smart Queue（需 confirm=True） 注意：暂无创建、更新或删除流量路由的工具。服务器可以读取控制器已有的路由并配置 Smart Queue，但新路由需在控制台界面中创建。
流量流分析（仅本地 API）
- get_traffic_flows、get_traffic_flow_details：查看活跃流量流及其详情
- filter_traffic_flows：按源、目的、应用过滤流量
- get_top_flows：按带宽排序的流量流
- get_flow_statistics、get_flow_analytics：聚合统计与趋势分析
- get_flow_risks：带安全风险评分的流量
- get_flow_trends：历史流量趋势
- get_connection_states：当前 TCP/UDP 连接状态
- get_client_flow_aggregation：按客户端聚合流量
- block_flow_application：阻断匹配某应用的流量
- block_flow_source_ip、block_flow_destination_ip：按源 IP 或目的 IP 阻断流量
- find_flows_for_rule_reference：查找匹配某防火墙规则的流量
- export_traffic_flows：导出流量为 JSON/CSV
- stream_traffic_flows：实时流事件
流量匹配列表（本地 API）
- list_traffic_matching_lists、get_traffic_matching_list：列出或获取匹配列表（IP 或端口）
- create_traffic_matching_list、update_traffic_matching_list：创建或更新列表条目
- delete_traffic_matching_list：删除列表（需 confirm=True）
深度包检测（DPI）
- get_dpi_statistics：站点级 DPI 应用统计
- get_client_dpi：指定客户端的 DPI 明细
- list_top_applications：按传输字节排序的顶级应用
- list_dpi_applications、list_dpi_categories：已识别的 DPI 应用及分类
- list_countries：用于地理过滤的国家代码
RADIUS 与访客门户
- list_radius_profiles、get_radius_profile、create_radius_profile、update_radius_profile、delete_radius_profile：管理 RADIUS 服务器配置
- list_radius_accounts、get_radius_account、create_radius_account、update_radius_account、delete_radius_account：管理 RADIUS 用户账号与凭据/VLAN
- get_guest_portal_config、configure_guest_portal：查看或配置访客门户行为
- list_hotspot_packages、get_hotspot_package、create_hotspot_package、update_hotspot_package、delete_hotspot_package：管理热点访问套餐（时长、配额、价格）
使用方式
通过 MCP 工具调用执行上述操作。示例工作流：
- 维护前备份：在站点 default 触发备份，等待完成并校验后再进行固件升级。
- 排查带宽峰值：获取最近 30 分钟的 Top 流量流，再按客户端聚合，定位占用带宽的设备。
- 访客网络阻断流媒体：先获取 DPI 分类找到流媒体分类 ID，再查找匹配的流量并针对每条流量用 block_flow_application 传入对应 flow_id 进行阻断。该工具针对单个流量的目的地址生效，参数为 flow_id 和可选时长，而非分类或区域。
- 为 WPA2-Enterprise 配置 RADIUS：用 create_radius_profile 创建配置，需要认证服务器地址和共享密钥 auth_secret（该密钥为必填项），然后将企业 SSID 更新为使用该配置的 WPA2-Enterprise。
- 查看已有路由：用 list_traffic_routes 查看每条路由的源、网关和优先级。
适用场景
- UniFi 多站点网络的集中状态查看与健康评估
- 备份计划管理与恢复演练
- 带宽异常排查与流量流向分析
- 基于应用的流量阻断与风险流量识别
- RADIUS 认证与访客热点套餐配置
限制
- 多站点聚合与 ISP 指标功能依赖云 API 或 Site Manager 访问权限。
- 流量流分析与流量路由读取仅支持本地 API。
- 流量路由的新建、更新、删除暂无工具，需在控制台界面操作。
- 恢复备份、删除备份、配置 Smart Queue、删除流量匹配列表等操作要求 confirm=True。
- 资料未提供具体安装命令、定价、平台版本要求与效果说明。