UniFi MCP

这是什么： 一个 Model Context Protocol (MCP) 服务器集合，让 AI 助手（如 Claude、Codex 或自定义代理）能与 Ubiquiti UniFi 控制器交互。它将 Network、Protect（摄像头）和 Access（门禁/访客）功能公开为可供代理调用的工具。

主要组件：

• Network MCP（210 个工具）、Protect MCP（63 个工具）、Access MCP（37 个工具）——每个分别对应一个 UniFi 应用。
• API 服务器 – 一个独立的 HTTP 服务（REST + GraphQL + SSE），适用于自定义应用和自动化，并具备范围限定的 API 密钥。
• Cloud Relay – 一个远程访问的 Beta 解决方案：由 Cloudflare 托管的 Worker 网关与本地 relay sidecar 配对，通过 WebSocket 路由 MCP 调用，避免直接暴露本地服务器。
• 代理插件 – 官方包，适用于 Claude Code、Codex 和 OpenClaw，将 MCP 服务器与设置技能和安全防护措施捆绑在一起。

工作原理：

• 服务器使用本地管理员账户（非 SSO）连接到您的 UniFi 控制器。
• 代理通过标准 MCP 发现调用工具，例如 unifi_list_clients、unifi_create_firewall_rule 或 unifi_get_motion_events。
• 变更操作使用预览后确认流程；设置将凭据存储在私人文件中，避免泄露机密。
• 延迟加载模式通过公开 meta-tools 来缩小上下文，这些 meta-tools 会按需注册领域工具。
• 响应大小会根据 MCP 协议版本自适应调整，以确保兼容性。

快速开始：

• 对于 Claude Code：/plugin marketplace add sirkirby/unifi-mcp，然后安装插件。
• 对于其他客户端：运行 uvx unifi-network-mcp@latest 等，并设置环境变量。

使用案例：

• “显示 Guest VLAN 上所有客户端的信号强度。”
• “列出过去一小时内检测到动作的摄像头。”
• “为 John Smith 创建明天 9–5 的访客通行证。”
• 跨产品智能：结合 Network + Protect 上下文调查事件。

此项目积极开发中（插件固定于服务器 0.37.x），具备安全模型，并以 MIT 许可证发布。这是一个真实且重要的 AI 驱动基础设施管理工具。