用途:这是一套引导式配置流程,帮用户完成 UniFi Network MCP 服务器与 UniFi 控制器的连接设置。流程用 AskUserQuestion 每次只问一个问题,得到回答后再继续。
主要步骤与能力:
- 控制器主机:询问 UniFi 控制器的 IP 地址或主机名。
- 凭据:需要本地管理员账号的用户名与密码(非 Ubiquiti SSO 账号),两者必填。可选 API Key;资料说明 API Key 认证仍属实验性,仅限只读操作和部分工具,Ubiquiti 仍在扩展其支持,询问用户是否配置,若配置则作为 UNIFI_NETWORK_API_KEY 写入。
- 可选设置:可选“使用默认值”(端口 443、站点 default、关闭 SSL 校验、惰性工具加载)或“自定义”(逐项询问端口、站点名、SSL 校验、工具注册模式)。
- 权限配置:默认高风险类别为只读。可选仅只读、启用常见写入权限(防火墙、端口转发、QoS、流量路由、VPN 客户端)、启用除删除外的全部写入权限,或自定义要启用的类别。
- 写入配置:按平台使用脚本把值写入 .claude/settings.local.json,脚本会创建文件、合并已有环境变量并对敏感值做掩码显示。macOS/Linux 用 bash ${CLAUDE_PLUGIN_ROOT}/scripts/set-env.sh,Windows 用 powershell -ExecutionPolicy Bypass -File "${CLAUDE_PLUGIN_ROOT}/scripts/set-env.ps1"。只传用户提供了值的变量,使用 UNIFI_NETWORK_ 前缀以避免与其他服务器插件冲突。若启用了权限,再单独调用一次脚本传入相应权限变量,例如 UNIFI_POLICY_NETWORK_FIREWALL_POLICIES_CREATE=true 等。“启用全部写入”的常见变量涵盖网络、WLAN、设备、客户端、防火墙策略、端口转发、流量路由、QoS 规则、VPN 客户端、路由的创建或更新。
- 验证与重启:提示配置已保存,重启 Claude Code 以连接 MCP 服务器,重启后可运行 /mcp 验证连接,或直接询问网络情况,并展示配置摘要表。
适用场景:在本地为 UniFi Network 环境接入 MCP 服务器时使用。限制:需要本地管理员凭据;API Key 支持有限;资料未提供具体版本要求、完整可用工具清单或收费信息。