适合谁
- 需要通过 AI 助手管理 UniFi Network 控制器的网络管理员。
- 运行本地 UniFi 部署并希望自动化网络运维的家庭实验室或小型组织。
U
60FMRS · C
资料显示这是一个由 sirkirby 维护的 MIT 开源 UniFi Network MCP 服务器，而非 Ubiquiti 官方服务器。其范围限于 Network 控制器管理；Protect、Access、中继和独立 API 服务不应归属于本服务器。
UniFi Network MCP 是一个通过 MCP 管理 UniFi Network 控制器的独立开源服务器，可处理网络设备、客户端、防火墙、VLAN、VPN 等网络管理任务。该仓库还包含 Protect 和 Access 服务器；本资料仅描述 apps/network/server.json 对应的 Network 服务器。该服务器版本为 0.27.0，提供 189 个工具，使用 stdio 传输。
工具能力
暂未整理工具清单。
安装接入
使用 uvx 启动 unifi-network-mcp，并配置 UNIFI_HOST、UNIFI_USERNAME 和 UNIFI_PASSWORD。需要连接本地 UniFi 控制器，并使用本地管理员或服务账户；不要使用 Ubiquiti SSO 云账户。可选配置 UNIFI_API_KEY、UNIFI_PORT、UNIFI_VERIFY_SSL 和 UNIFI_SITE。
claude_desktop_config.json
{"mcpServers":{"unifi-network":{"command":"uvx","args":["unifi-network-mcp@latest"],"env":{"UNIFI_HOST":"192.168.1.1","UNIFI_USERNAME":"admin","UNIFI_PASSWORD":"your-password","UNIFI_PORT":"443","UNIFI_VERIFY_SSL":"false","UNIFI_SITE":"default"}}}}
选型与风险
不适合谁
- 只使用 Ubiquiti SSO 云账户、SSO MFA 或本地 2FA 的账户配置。
- 不使用 UniFi Network 控制器的用户。
- 需要 Protect 摄像头或 Access 门禁功能的场景；这些属于同仓库的其他服务器。
所需权限
- 控制器 IP 地址或主机名。
- 本地 UniFi 管理员或服务账户用户名和密码。
- 账户应具备所需网络管理权限，并按可接受范围进行授权。
- 可选的 UniFi API key，用于部分能力。
风险与副作用
- 服务器可管理防火墙、VLAN、VPN 和网络设备，错误操作可能影响网络连通性或安全边界。
- 管理员凭据具有较高敏感性，应使用专用本地服务账户并妥善保护。
- UNIFI_VERIFY_SSL 默认值为 false，可能降低 TLS 证书验证保护。
- 关闭敏感字段脱敏可能将 Wi-Fi、VPN 或其他秘密暴露给代理上下文和日志。
常见排障
- 确认 UNIFI_HOST 指向可访问的 UniFi 控制器，并检查 HTTPS 端口配置。
- 确认使用的是本地管理员或服务账户，而不是 Ubiquiti SSO 云账户。
- 检查用户名、密码、站点名称和可选 API key 是否正确。
- 如果证书验证导致连接问题，检查 UNIFI_VERIFY_SSL 配置。
- 确认账户拥有执行目标网络操作所需的权限。
使用场景
查询 UniFi 网络设备和客户端状态。
管理防火墙规则、VLAN 和 VPN。
查看访客 VLAN 客户端的信号强度和数据使用情况。
审计防火墙策略并分析网络流量。
支持客户端
Claude Desktop完整支持
Codex完整支持
OpenClaw完整支持