适合谁
- 使用本地 UniFi 控制器的家庭自动化用户
- 需要通过 AI 助手查询 Protect 摄像头、录像和检测事件的用户
- 能够提供本地管理员或服务账户的 UniFi Protect 部署
U
66FMRS · C
资料表明该服务器专注于 UniFi Protect，并通过 stdio 发布；安装包为 PyPI 的 unifi-protect-mcp 0.7.5。仓库同时包含 Network 和 Access 服务器，因此不能将它们的工具归属于本服务器。
UniFi Protect MCP 是一个通过标准输入输出运行的 MCP 服务器，用于管理 UniFi Protect 摄像头、事件、录像和智能检测。该服务器属于包含多个 UniFi MCP 服务器的仓库，本资料仅覆盖 Protect 服务器。版本为 0.7.5，提供 61 个工具。
工具能力
暂未整理工具清单。
安装接入
使用 uvx 运行 unifi-protect-mcp@latest，并配置 UNIFI_PROTECT_HOST、UNIFI_PROTECT_USERNAME 和 UNIFI_PROTECT_PASSWORD。也可使用共享的 UNIFI_HOST、UNIFI_USERNAME 和 UNIFI_PASSWORD 变量。UNIFI_PORT 默认为 443，UNIFI_VERIFY_SSL 默认为 false；UNIFI_API_KEY 为可选实验性配置。
claude_desktop_config.json
{"mcpServers":{"unifi-protect":{"command":"uvx","args":["unifi-protect-mcp@latest"],"env":{"UNIFI_PROTECT_HOST":"192.168.1.1","UNIFI_PROTECT_USERNAME":"admin","UNIFI_PROTECT_PASSWORD":"your-password"}}}}
选型与风险
不适合谁
- 只使用 Ubiquiti SSO 云账户的用户
- 需要 Network 或 Access 服务器功能的用户
- 需要明确工具名称和完整工具清单但仅依据当前资料进行评估的用户
所需权限
- 需要 UniFi 控制器 IP 或主机名
- 需要本地管理员账户用户名和密码
- 可选的 API 密钥用于部分能力；该配置标记为实验性
- 账户权限范围应符合用户愿意授予 MCP 服务器的范围
风险与副作用
- 摄像头事件和录像可能包含敏感的家庭或场所信息
- 服务器具备管理 Protect 数据和设备的能力，账户权限过宽会扩大影响范围
- UNIFI_VERIFY_SSL 默认值为 false，可能不会验证 SSL 证书
- 用户名、密码和可选 API 密钥属于敏感配置，应妥善保护
常见排障
- 确认控制器主机地址正确且可访问
- 确认使用的是本地 UniFi 账户，而不是 Ubiquiti SSO 云账户
- 检查 HTTPS 端口；默认值为 443
- 若使用自签名证书，检查 UNIFI_VERIFY_SSL 设置
- 确认 Protect 专用变量名称正确，或改用共享的 UNIFI_* 变量
- API 密钥是可选实验性配置，基础连接应先检查用户名和密码
使用场景
查询最近一小时检测到移动的摄像头
查看指定摄像头当天的人员和车辆智能检测事件
查找本周车道中的白色厢式车检测记录
支持客户端
Claude Desktop完整支持
Codex部分支持
OpenClaw部分支持