M
MCP 精选目录 CURATED DIRECTORY
已收录 911 个 MCP Server
EN
← 返回目录
U

UniFi Protect MCP

社区
通过 MCP 管理 UniFi Protect 摄像头与事件。
查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗
分类
其他 第 30 / 230
Stars
★ 921 非常热门
传输方式
stdio（本地进程）
运行环境
Python 3.13+
凭据
需要 API Key / 凭据
许可证
MIT
最近提交
66FMRS · C

资料表明该服务器专注于 UniFi Protect，并通过 stdio 发布；安装包为 PyPI 的 unifi-protect-mcp 0.7.5。仓库同时包含 Network 和 Access 服务器，因此不能将它们的工具归属于本服务器。

最强项 · 文档质量 15/20 最弱项 · 可靠性 11/20

可靠性
11/20
安全与权限
13/20
维护活跃度
14/20
文档质量
15/20
安装易用性
13/20
查看各项评分依据
可靠性 11/20
清单明确了 Protect 服务器、stdio 传输、版本和 61 个工具，README 也给出可执行的启动入口与 MCP 握手模式说明，因此正常路径看起来可行。由于提供的材料没有 Protect 专属源码、CI 工作流、提交测试或错误路径证据，无法验证启动、工具列表一致性、依赖失败和边界行为；按静态校准不超过 12 分，故扣分。
安全与权限 13/20
凭据变量被标记为 secret，文档说明使用本地控制器账户、敏感字段默认脱敏，并声称所有变更采用预览后确认；这些证据支持基本的数据边界和副作用控制。扣分原因是默认关闭 SSL 验证、支持管理员凭据、权限范围与 Protect 工具的最小权限映射未展示，API key 的能力边界也未充分说明；没有证据证明达到完整最小权限。
维护活跃度 14/20
项目未归档，拥有 MIT 许可证、明确的 0.7.5 版本和 PyPI 发布路径，且仓库提供维护者与 issue 入口；这些是持续维护的正面信号。扣分原因是材料没有提交历史、发布频率、依赖更新、漏洞响应渠道或维护承诺的具体证据，开放 issue 数量本身不证明响应质量。
文档质量 15/20
README 提供 Protect 的安装命令、客户端配置、环境变量、认证要求、示例任务、脱敏说明、响应模式和配置文档链接，整体覆盖面较好。扣分原因是没有提供 61 个 Protect 工具的参数、返回结构、限制、兼容性矩阵或具体故障排查证据；部分详细内容仅以链接形式引用，且仓库级说明混合了其他服务器，需避免将其误归属于 Protect。
安装易用性 13/20
文档给出 uvx 直接启动方式，以及 Claude Desktop、Codex、Claude Code 和 OpenClaw 的配置或安装路径；Protect 的变量和默认端口也明确，步骤总体可操作。扣分原因是需要 Python 3.13+、本地账户和控制器准备，未展示 Protect 专属 CI 或安装后连接验证测试，SSL 默认设置还可能需要用户额外处理；因此不能给出高于静态证据支持的分数。

静态评测 · 未实际运行收录于 2026-08-14

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

  • 使用本地 UniFi 控制器的家庭自动化用户
  • 需要通过 AI 助手查询 Protect 摄像头、录像和检测事件的用户
  • 能够提供本地管理员或服务账户的 UniFi Protect 部署

不适合谁

  • 只使用 Ubiquiti SSO 云账户的用户
  • 需要 Network 或 Access 服务器功能的用户
  • 需要明确工具名称和完整工具清单但仅依据当前资料进行评估的用户

所需权限

  • 需要 UniFi 控制器 IP 或主机名
  • 需要本地管理员账户用户名和密码
  • 可选的 API 密钥用于部分能力；该配置标记为实验性
  • 账户权限范围应符合用户愿意授予 MCP 服务器的范围

风险与副作用

  • 摄像头事件和录像可能包含敏感的家庭或场所信息
  • 服务器具备管理 Protect 数据和设备的能力，账户权限过宽会扩大影响范围
  • UNIFI_VERIFY_SSL 默认值为 false，可能不会验证 SSL 证书
  • 用户名、密码和可选 API 密钥属于敏感配置，应妥善保护

安装接入

准备工作

运行环境：Python 3.13+

UNIFI_PROTECT_HOST 必填 UniFi Protect 控制器的 IP 或主机名，如 192.168.1.1；优先于共享的 UNIFI_HOST。
UNIFI_PROTECT_USERNAME 必填 本地管理员/服务账号用户名，不要使用 Ubiquiti SSO 云账号。
UNIFI_PROTECT_PASSWORD 必填密钥 上述本地账号的密码；优先于共享的 UNIFI_PASSWORD。
UNIFI_HOST 必填 共享回退变量：控制器 IP 或主机名，未设置服务器专属变量时使用。
UNIFI_USERNAME 必填 共享回退变量：本地管理员用户名。
UNIFI_PASSWORD 必填密钥 共享回退变量：本地管理员密码。
UNIFI_PROTECT_API_KEY 可选密钥 可选的 UniFi API key，用于部分 Protect 设置更新等能力（实验性）；优先于 UNIFI_API_KEY。
UNIFI_API_KEY 可选密钥 共享回退变量：可选的 UniFi API key。
其他可选配置项（6 个）
UNIFI_PROTECT_PORT 可选 控制器 HTTPS 端口，默认 443；优先于 UNIFI_PORT。
UNIFI_PORT 可选 共享回退变量：控制器 HTTPS 端口，默认 443。
UNIFI_PROTECT_VERIFY_SSL 可选 是否校验 SSL 证书，默认 false；优先于 UNIFI_VERIFY_SSL。
UNIFI_VERIFY_SSL 可选 共享回退变量：是否校验 SSL 证书，默认 false。
UNIFI_PROTECT_MCP_CONTENT_MODE 可选 覆盖全局响应大小模式，可设为 compat 或 compact。
UNIFI_PROTECT_REDACT_SENSITIVE_FIELDS 可选 设为 false 时关闭敏感字段（密钥等）的 ***REDACTED*** 脱敏，仅限受信任的本地管理流程。

使用 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"}}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json
{
  "servers": {
    "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"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal
claude mcp add unifi-protect -e UNIFI_PROTECT_HOST=192.168.1.1 -e UNIFI_PROTECT_USERNAME=admin -e UNIFI_PROTECT_PASSWORD=your-password -- uvx unifi-protect-mcp@latest

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端连接后运行 tools/list，应能看到该服务器的工具（lazy 模式下先出现 *_tool_index 等元工具）；或直接问“列出我的 Protect 摄像头”，能返回摄像头列表即说明连接成功。

常见排障

  1. 确认控制器主机地址正确且可访问
  2. 确认使用的是本地 UniFi 账户，而不是 Ubiquiti SSO 云账户
  3. 检查 HTTPS 端口；默认值为 443
  4. 若使用自签名证书，检查 UNIFI_VERIFY_SSL 设置
  5. 确认 Protect 专用变量名称正确，或改用共享的 UNIFI_* 变量
  6. API 密钥是可选实验性配置，基础连接应先检查用户名和密码

试试这样问

连接成功后，可以直接对 AI 助手这样说：

  • 列出过去一小时内检测到运动的所有摄像头
  • 显示今天前门摄像头的人员和车辆智能检测事件
  • 查找本周车道上白色货车的检测记录

使用场景

查询最近一小时检测到移动的摄像头
查看指定摄像头当天的人员和车辆智能检测事件
查找本周车道中的白色厢式车检测记录

支持客户端

Claude Desktop
Codex部分支持
OpenClaw部分支持

依据项目文档列出，未经本站实测。

详细介绍

UniFi Protect MCP 是一个通过标准输入输出运行的 MCP 服务器，用于管理 UniFi Protect 摄像头、事件、录像和智能检测。该服务器属于包含多个 UniFi MCP 服务器的仓库，本资料仅覆盖 Protect 服务器。版本为 0.7.5，提供 61 个工具。

同类可选方案

BioMCP 75 · B

统一的命令行语法，接入约30个可信生物医学数据源。

★ 659 · 工具数 11 与当前对比 →
与其他 MCP 横向对比

同仓库的其他 Server

UniFi Access MCPUniFi Network MCP

源版本 fbd083c62ec8 数据同步于 2026-10-19 查看 FMRS 评分方法