Unifi Protect MCP

UniFi保护MCP服务器

一个MCP（模型上下文协议）服务器，公开UniFi Protect的集成REST API作为Claude Code和其他MCP客户端的工具。与UniFi Protect API一致 7.1.60 --73种工具，涵盖摄像头、灯、传感器、铃声、查看器、警报器、遥控器、继电器、扬声器、网桥、链接站、报警中心、手臂配置文件、实时视图、文件、用户、NVR状态和WebSocket订阅。

先决条件

• Node.js 20+
• 启用集成API的UniFi Protect系统
• 从UniFi Protect控制台生成的API密钥

设置

快速启动（npx）

只需一个命令即可添加到Claude Code中，无需克隆或构建：

claude mcp add-json unifi-protect '{"command":"npx","args":["-y","@owine/unifi-protect-mcp@latest"],"env":{"UNIFI_PROTECT_HOST":"192.168.1.1","UNIFI_PROTECT_API_KEY":"your-api-key","UNIFI_PROTECT_VERIFY_SSL":"false"}}' -s user

使用 -s user 确保所有项目的全球可用性，或 -s project 仅适用于当前项目。

来源

如果您更喜欢在本地构建：

git clone https://github.com/owine/unifi-protect-mcp.git
cd unifi-protect-mcp
npm install
npm run build

然后添加到克劳德代码中：

claude mcp add-json unifi-protect '{"command":"node","args":["/path/to/unifi-protect-mcp/dist/index.js"],"env":{"UNIFI_PROTECT_HOST":"192.168.1.1","UNIFI_PROTECT_API_KEY":"your-api-key","UNIFI_PROTECT_VERIFY_SSL":"false"}}' -s user

环境变量

手动配置

或者，添加到您的 ~/.claude.json 在顶层之下 "mcpServers" 按键：

{
  "mcpServers": {
    "unifi-protect": {
      "command": "npx",
      "args": ["-y", "@owine/unifi-protect-mcp@latest"],
      "env": {
        "UNIFI_PROTECT_HOST": "192.168.1.1",
        "UNIFI_PROTECT_API_KEY": "your-api-key",
        "UNIFI_PROTECT_VERIFY_SSL": "false"
      }
    }
  }
}

安全功能

此服务器为负责任的操作提供分层安全控制：

• 工具注释 --每个工具都声明 readOnlyHint 和 destructiveHint 因此MCP客户端（如Claude Code）可以做出明智的确认决策
• 只读模式 --默认情况下启用。仅注册读取操作（列表、获取、快照）。集 UNIFI_PROTECT_READ_ONLY=false 启用写入/修改工具
• 确认参数 --最危险的工具(protect_disable_mic, protect_trigger_alarm_webhook)要求明确 confirm: true 调用成功所必需的参数
• 模拟运行支持 --所有书写工具（带 confirm)接受可选 dryRun: true 参数，返回在不进行任何更改的情况下会发生什么的预览

工具（共73个）

系统（2）

订阅（2）

摄像机（12）

灯光（3）

传感器（3）

编钟（3）

浏览者（3）

警报器（6）

福布斯 (3)

继电器（4）

演讲者（4）

桥梁（3）

链接站（3）

报警集线器（4）

Arm Profiles（7）-本地报警管理器

实时视图（4）

报警和文件（3）

用户（4）

发展

npm run build        # Compile TypeScript
npm start            # Run the server
npm run typecheck    # Type-check without emitting
npm run lint         # ESLint
npm test             # Run all tests (vitest)

承诺约定

• feat: ... --新功能（次要版本凹凸）
• fix: ... --错误修复（补丁版本碰撞）
• feat!: ... 或 BREAKING CHANGE: 页脚--突破性更改（主要版本凸起）
• chore:, docs:, ci:等等。--无版本冲突

关于推送 main，release请打开一个发布PR，该PR会暂停版本和更新 CHANGELOG.md合并该PR会自动发布到npm。

要覆盖版本号，请添加 Release-As: x.x.x 在提交主体中：

git commit --allow-empty -m "chore: release 2.0.0" -m "Release-As: 2.0.0"

许可证

麻省理工学院