SuperAPI AI 工具集

unifi

智能体与模型

查看项目

更新于 10-15 21:38

技能介绍

用途:通过 UniFi MCP Server 与 UniFi Network Controller 交互,管理 UniFi 设备、客户端、网络、VLAN、WiFi、防火墙等。提供 86+ 个 MCP 工具,分属六个能力域;支持 local、cloud-v1、cloud-ea 三种 API 模式,区域防火墙功能需 UniFi Network 9.0+。

主要能力:网络操作(客户端、VLAN、WiFi/SSID、DHCP 保留、DNS、WAN、Voucher);设备管理(清单、采纳、重启/升级、射频配置、端口配置、交换/堆叠、拓扑、诊断);安全(防火墙规则、防火墙组、区域防火墙 ZBF、ACL、端口转发、VPN、站点间 VPN、内容过滤);系统与监控(站点、多站点聚合、备份、QoS/流量路由、流量分析、DPI、RADIUS、访客门户、热点套餐)。

使用方式:MCP 客户端配置示例:{"mcpServers":{"unifi":{"command":"uvx","args":["unifi-mcp-server"],"env":{"UNIFI_API_KEY":"your-api-key","UNIFI_API_TYPE":"local","UNIFI_LOCAL_HOST":"192.168.2.1"}}}}。CLI 安装:pip install unifi-mcp-server,或 uvx unifi-mcp-server --help;设置 export UNIFI_API_KEY=your-api-key、UNIFI_API_TYPE=local、UNIFI_LOCAL_HOST=192.168.2.1 后可直接运行,如 unifi-cli list-clients --site default、unifi-cli get-device-details --site default --device-id <id>。可用 --profile network/devices/security/system 缩小工具范围。

环境变量:UNIFI_API_KEY(必填)、UNIFI_API_TYPE(local/cloud-v1/cloud-ea,默认 cloud-v1)、UNIFI_LOCAL_HOST(仅本地模式)、UNIFI_SITE(默认 default)、UNIFI_VERIFY_SSL(默认 true)。

限制:区域防火墙、流量流、防火墙规则/区域仅 local 模式支持;ACL 与流量匹配列表仅 cloud-v1/cloud-ea 支持;站点聚合与设备管理三种模式均支持。其余细节暂未提供。