sirkirby/unifi-mcp

解决的问题

UniFi MCP 允许 AI 助手和自动化工具与 Ubiquiti UniFi 控制器进行交互。它弥合了自然语言接口与复杂网络基础设施管理之间的差距，使用户能够使用 AI 代理查询、审计和修改其 UniFi Network、Protect 和 Access 部署。

工作原理

该项目实现了 Model Context Protocol (MCP)，将 UniFi 控制器功能暴露为一组可查询和可组合的工具。它由多个专用服务器（网络、Protect 和 Access）组成，通过管理员账户连接到本地控制器。

对于远程访问，它使用“Cloud Relay”系统：由 Cloudflare 托管的 Worker 网关充当经过身份验证的边缘端点，通过 WebSocket 与本地 Relay 侧车通信，将请求转发到本地 MCP 服务器。它还包含一个独立的 REST 和 GraphQL API 服务器，供非 MCP 消费者使用。

适用人群

专为使用 UniFi 硬件并希望使用 AI 驱动的代理（如 Claude Code、Codex 或 OpenClaw）而非手动浏览仪表板来管理其基础设施的网络管理员和家庭实验室爱好者设计。

主要亮点

• 全面的工具集：涵盖网络（192 个）、Protect（61 个）和 Access（36 个）领域的数百个工具。
• 代理技能：包含预定义技能，用于执行复杂任务，如网络健康检查、100 分制的防火墙审计以及安全摘要。
• 安全优先：所有变更操作均采用“预览-确认”流程，并自动从代理上下文中屏蔽敏感字段（如 Wi-Fi 密码和 VPN 密钥）。
• 灵活部署：支持本地直接执行、AI IDE 插件式安装，以及用于远程管理的云中继架构。