用途:为 UniFi Access 相关缺陷报告准备一份最小化、经脱敏的支持包,并协助用户在本地审阅,不代用户对外发布。
主要能力:通过 access_get_support_bundle 工具采集支持包,仅将 JSON 返回给配置好的 MCP 客户端。支持 summary 与 connectivity 两种探测。summary 为本地/缓存模式,不联系控制器;connectivity 通过现有认证会话发起一次有界只读请求,调用前需用户明确确认。支持包保留每个探测项的状态,包括 unavailable、unsupported、partial、capped 等。
使用方式:默认调用 access_get_support_bundle(probe="summary");用户选择并确认其他受支持探测时才切换。不得经由 _execute、_batch、中继或多位置扇出调用该工具。若工具缺失,建议更新 access 插件或包并重启 MCP 客户端;若服务器无法启动或注册工具,可使用 $unifi-access-setup 获取安装帮助,并回退到缺陷表单中手工填写版本、控制器、安装、客户端、预期、实际和复现步骤等字段。不要索取凭据、原始配置、控制器载荷或大范围诊断日志。
本地审阅:向用户展示完整返回的 JSON,并在任何外部共享前暂停。需说明支持包是脱敏而非匿名,版本、运行模式、能力标志和粗粒度结构形态可能关联或指纹化环境;支持包排除凭据、控制器地址、标识符、原始资源值、响应体、原始异常文本、日志、配置文件以及调用方提供的路径或端点;UNIFI_MCP_DIAGNOSTICS 日志属于独立的运维设施,不自动适合公开张贴。用户可删除不想分享的可选段或值,但尽量保留 schema_version、product、probe 及相关证据。请用户确认已审阅 JSON,且未手动加入原始日志、载荷、配置、凭据、控制器标识符或安全漏洞细节。
缺陷报告准备:审阅后提供可粘贴到支持包(可选)表单字段的 fenced json 代码块,或一个可在拖入 GitHub 前检查的本地 .json 文件。将文件拖入 GitHub 即开始发布/上传,公开问题中的附件可被公开访问;不建议截图 JSON。该技能本身绝不 上传、附加、粘贴、发布或提交支持包,仅返回审阅后的 JSON 或其本地路径。
适用场景:UniFi Access 相关缺陷报告的准备与本地审阅。限制:summary 仅本地/缓存,不能证明控制器连通性或整体产品健康状况;connectivity 仅一次有界请求,不是全面审计;失败或缺失的探测不能转为成功空结果或全清结论。需区分观察到的支持包字段与诊断假设,身份信息不做评估。规范指南见 https://github.com/sirkirby/unifi-mcp/blob/main/docs/support-bundles.md。