用途:在 UniFi 网络上以自然语言驱动防火墙策略管理,把用户意图翻译为 MCP 工具调用,覆盖规则创建、修改、删除、启停与审查,以及内容过滤和流量策略。
主要能力:读取、创建、更新、切换策略;按区域(zone)的 V2 策略创建;策略排序读取与调整;DPI 应用识别用于应用级规则;内置策略模板(IoT 隔离、访客锁定、儿童内容过滤、屏蔽 BitTorrent、工作 VPN 分隧道、摄像头隔离)与 DPI 分类映射参考。
必要用法:需 unifi-network MCP 服务器,先确认 UNIFI_NETWORK_HOST(或 UNIFI_HOST)已设置,并用 unifi_tool_index 验证。每次变更前快照(unifi_list_firewall_policies、unifi_list_firewall_zones、unifi_list_firewall_groups)写盘保存,变更后做 diff 对比。所有变更工具不加 confirm=true 时返回预览,须先展示预览、取得用户明确确认后再执行;一次只做一处变更。
限制:策略排序使用官方集成 API,需要 API key(UNIFI_API_KEY 或 UNIFI_NETWORK_API_KEY),本地用户名密码会话无法调用排序端点。删除默认关闭,需设置 UNIFI_POLICY_NETWORK_FIREWALL_POLICIES_DELETE=true 等权限环境变量。DPI 规则可被 VPN 绕过。MCP 服务器不可达时无变更回退方案,需转向 unifi-network-setup 技能诊断。