SuperAPI AI 工具集

unifi-access

安全与审计

查看项目

更新于 10-16 06:14

技能介绍

用途:该技能接入 UniFi Access MCP 服务器,用于查询和管理 UniFi Access 门禁控制器,覆盖门、锁、凭证、访客、门禁策略和事件,共 29 个工具。

主要能力:门锁控制(access_lock_door / access_unlock_door,解锁后按时长自动重新上锁,默认 2 秒);实时事件(access_recent_events 从 websocket 缓冲区即时读取,类型含 door_open、door_close、access_granted、access_denied、door_alarm);历史事件(access_list_events,可按时间/门/用户过滤,主题有 admin 或 admin_activity);活动汇总(access_get_activity_summary 聚合某时间段事件,用于安全审计);凭证(创建 NFC、PIN 或移动凭证);访客通行证(使用 ISO 8601 起止时间,可选邮箱/电话通知)。

使用方式:服务器默认惰性加载,仅注册元工具 access_tool_index(按名称/描述发现工具,可用 category、search、include_schemas 过滤)、access_execute(按名称调用工具)、access_batch(并行运行多个工具)、access_batch_status(查看异步批处理状态)。流程为先调 access_tool_index 找到工具,再用 access_execute 调用;多个独立查询用 access_batch。返回格式统一为成功、错误或需确认三种,应先检查 success。

安全模型:所有变更默认禁用。读操作始终可用;变更需通过环境变量显式开启,如 UNIFI_POLICY_ACCESS_DOORS_UPDATE=true 等。每个变更采用先预览后确认:默认调用返回预览,带 confirm=true 才执行。

认证与配置:API 密钥(端口 12445)用于只读操作,用户名+密码(端口 443)用于变更。可运行 /unifi-access:setup 或手动设置 UNIFI_ACCESS_HOST、UNIFI_ACCESS_API_KEY、UNIFI_ACCESS_USERNAME、UNIFI_ACCESS_PASSWORD。完整工具清单见 references/access-tools.md。

限制:变更操作必须显式授权并二次确认;API 密钥单独不足以完成写操作;资料未提供收费、价格与具体平台兼容性信息。