用途:通过 MCP 查询和管理 UniFi Protect NVR,覆盖摄像头、智能检测、Find Anything 检测搜索、录像、快照、灯光、传感器、门铃、Known Faces、车牌与 Alarm Manager(布防/撤防)。需先经 MCP 发现确认所需服务器/工具可用,发现本身不代表控制器已连通或已授权。
主要能力:提供 63 个工具。protect_get_snapshot 在 include_image=true 时返回内联 base64 JPEG;protect_get_camera_streams 返回 RTSP/RTSPS 流元数据,原始 URL 默认以 REDACTED 返回。protect_list_smart_detections 可按 person、vehicle、animal、package、face、licensePlate 过滤,信号高于原始移动检测。Find Anything 先用 protect_detection_search_labels 发现控制器支持的标签,再用 protect_search_detections 按车型、颜色、设备等搜索,可参考 references/protect-tools.md。protect_recent_events 读取约 100 条、TTL 5 分钟的 websocket 缓冲;历史查询用 protect_list_events,默认 30 条。protect_export_clip 只返回元数据而非视频,最大 2 小时,支持 timelapse(fps 4=60x、8=120x、20=300x)。PTZ 仅缩放可用,平移/倾斜用已保存位置。
用法:默认为懒加载,仅注册元工具 protect_tool_index、protect_execute、protect_batch、protect_batch_status;先索引再执行,批量用 protect_batch,异步任务用 protect_batch_status。需本地管理员用户名和密码(非 Ubiquiti SSO),可选 API key 支持部分能力。可运行 /unifi-protect:unifi-protect-setup,或设置 UNIFI_PROTECT_HOST=192.168.1.1、UNIFI_PROTECT_USERNAME=admin、UNIFI_PROTECT_PASSWORD=your-password。
限制:读取始终可用;所有变更默认禁用,需按类别显式开启环境变量(如 UNIFI_POLICY_PROTECT_CAMERAS_UPDATE=true、LIGHTS、CHIMES、ALARM、RECOGNITION_UPDATE、RECOGNITION_DELETE;类别段为服务器配置键,UNIFI_POLICY_PROTECT_CAMERA_UPDATE 不会被读取)。每次变更先返回预览,需 confirm=true 才执行。返回体先判断 success;需附 Coverage and Limitations,区分观测、假设与身份,不得从不可用、部分或封顶数据声称完整覆盖或全部正常。其他事实暂未提供。