UniFi Network MCP

社区

通过 MCP 管理 UniFi 网络基础设施。

分类: 其他第 71 / 230
Stars: ★ 921 非常热门
传输方式: stdio（本地进程）
运行环境: Python 3.13+
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 3 天前

60FMRS · C

资料显示这是一个由 sirkirby 维护的 MIT 开源 UniFi Network MCP 服务器，而非 Ubiquiti 官方服务器。其范围限于 Network 控制器管理；Protect、Access、中继和独立 API 服务不应归属于本服务器。

最强项 · 文档质量 14/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

14/20

维护活跃度

11/20

文档质量

14/20

安装易用性

13/20

查看各项评分依据

可靠性 8/20: 清单声明了可通过 PyPI 以 stdio 启动的 Network 服务器，并说明了 MCP 工具发现、响应模式和错误相关配置，正常路径看起来可行。但提供的材料没有该服务器的源代码、CI 工作流或已提交测试，无法验证初始化、工具列表、189 个工具与实际行为的一致性，也无法确认依赖和异常处理，因此按静态审查保守扣分。
安全与权限 14/20: 凭据在清单中标为 secret，README 说明默认敏感字段脱敏，并声称所有变更采用预览后确认；服务器连接本地控制器，且文档披露了本地账户要求和 API 数据边界。这些证据支持中上水平评分。但 UNIFI_VERIFY_SSL 默认值为 false，使用管理员或服务账户，且具体权限范围、每项工具的授权边界和危险操作确认实现无法从材料验证；README 还说明 MFA 不受支持，因此扣分。未发现红线风险证据。
维护活跃度 11/20: 仓库非归档，版本为 0.27.0，使用 MIT 许可证，且材料显示有明确的 GitHub 维护者、稳定状态和 PyPI 发布路径。可是没有提供提交频率、发布历史、依赖更新、问题响应、SECURITY 文件或安全响应渠道，不能把星标、开放问题数量或 README 的维护声明当作持续维护证据，因此评分有限。
文档质量 14/20: README 覆盖了服务器范围、安装方式、认证要求、环境变量、客户端示例、响应大小、脱敏、限制和部分使用场景，并链接到 Network 专属配置文档，整体可用。缺少实际提供的工具参数、返回结构、错误诊断、兼容性矩阵、成本说明和可审查的 Network 源码证据；README 还包含多个兄弟服务器和外围组件的信息，不能将其计入本服务器能力，因此扣分。
安装易用性 13/20: 提供了 uvx 启动命令、Claude Code、Codex、OpenClaw 和 Claude Desktop 配置示例，并列出运行时、控制器地址和本地账户要求，完成基本连接的路径较清楚。但仍需准备本地 UniFi 控制器和无 MFA 的账户，证书校验默认关闭，环境变量命名存在共享变量与 Network 前缀变量并存的复杂性；没有 CI 或提交测试证明安装和握手可复现，因此未接近满分。

静态评测 · 未实际运行收录于 2026-08-14

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

需要通过 AI 助手管理 UniFi Network 控制器的网络管理员。
运行本地 UniFi 部署并希望自动化网络运维的家庭实验室或小型组织。

不适合谁

只使用 Ubiquiti SSO 云账户、SSO MFA 或本地 2FA 的账户配置。
不使用 UniFi Network 控制器的用户。
需要 Protect 摄像头或 Access 门禁功能的场景；这些属于同仓库的其他服务器。

所需权限

控制器 IP 地址或主机名。
本地 UniFi 管理员或服务账户用户名和密码。
账户应具备所需网络管理权限，并按可接受范围进行授权。
可选的 UniFi API key，用于部分能力。

风险与副作用

服务器可管理防火墙、VLAN、VPN 和网络设备，错误操作可能影响网络连通性或安全边界。
管理员凭据具有较高敏感性，应使用专用本地服务账户并妥善保护。
UNIFI_VERIFY_SSL 默认值为 false，可能降低 TLS 证书验证保护。
关闭敏感字段脱敏可能将 Wi-Fi、VPN 或其他秘密暴露给代理上下文和日志。

安装接入

准备工作

运行环境：Python 3.13+

UNIFI_HOST 必填 UniFi 控制器的 IP 或主机名，例如 192.168.1.1，必填。

UNIFI_USERNAME 必填密钥本地管理员/服务账号用户名；不要使用 Ubiquiti SSO 云账号，必填。

UNIFI_PASSWORD 必填密钥上述本地账号的密码，必填。

UNIFI_API_KEY 可选密钥可选的 UniFi API key，用于防火墙策略排序等部分功能。

UNIFI_NETWORK_USERNAME 可选密钥 Network 服务器专用的本地账号用户名，优先于共享变量。

UNIFI_NETWORK_PASSWORD 可选密钥 Network 服务器专用的本地账号密码，优先于共享变量。

UNIFI_NETWORK_API_KEY 可选密钥 Network 服务器专用的 UniFi API key。

其他可选配置项（10 个）

UNIFI_PORT 可选控制器 HTTPS 端口，默认 443。

UNIFI_VERIFY_SSL 可选是否校验 SSL 证书，默认 false。

UNIFI_SITE 可选 UniFi 站点名称，默认 default。

UNIFI_MCP_CONTENT_MODE 可选全局响应模式：compat、compact 或 adaptive（默认，按协议版本自适应）。

UNIFI_REDACT_SENSITIVE_FIELDS 可选设为 false 可关闭敏感字段脱敏（默认开启，返回 ***REDACTED***），仅在可信本地管理场景使用。

UNIFI_NETWORK_HOST 可选 Network 服务器专用的控制器地址，优先于共享 UNIFI_HOST。

UNIFI_NETWORK_PORT 可选 Network 服务器专用的控制器端口。

UNIFI_NETWORK_VERIFY_SSL 可选 Network 服务器专用的 SSL 校验开关。

UNIFI_NETWORK_MCP_CONTENT_MODE 可选仅覆盖 Network 服务器的响应模式。

UNIFI_NETWORK_REDACT_SENSITIVE_FIELDS 可选仅覆盖 Network 服务器的脱敏开关。

使用 uvx 启动 unifi-network-mcp，并配置 UNIFI_HOST、UNIFI_USERNAME 和 UNIFI_PASSWORD。需要连接本地 UniFi 控制器，并使用本地管理员或服务账户；不要使用 Ubiquiti SSO 云账户。可选配置 UNIFI_API_KEY、UNIFI_PORT、UNIFI_VERIFY_SSL 和 UNIFI_SITE。

claude_desktop_config.json

{"mcpServers":{"unifi-network":{"command":"uvx","args":["unifi-network-mcp@latest"],"env":{"UNIFI_HOST":"192.168.1.1","UNIFI_USERNAME":"admin","UNIFI_PASSWORD":"your-password","UNIFI_PORT":"443","UNIFI_VERIFY_SSL":"false","UNIFI_SITE":"default"}}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "unifi-network": {
      "command": "uvx",
      "args": [
        "unifi-network-mcp@latest"
      ],
      "env": {
        "UNIFI_HOST": "192.168.1.1",
        "UNIFI_USERNAME": "admin",
        "UNIFI_PASSWORD": "your-password",
        "UNIFI_PORT": "443",
        "UNIFI_VERIFY_SSL": "false",
        "UNIFI_SITE": "default"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add unifi-network -e UNIFI_HOST=192.168.1.1 -e UNIFI_USERNAME=admin -e UNIFI_PASSWORD=your-password -e UNIFI_PORT=443 -e UNIFI_VERIFY_SSL=false -e UNIFI_SITE=default -- uvx unifi-network-mcp@latest

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端的工具列表中应出现 unifi-network-mcp 的工具（如 unifi_get_dashboard）；也可询问"显示当前所有已连接的客户端"，若返回控制器真实数据即证明连接成功。

常见排障

确认 UNIFI_HOST 指向可访问的 UniFi 控制器，并检查 HTTPS 端口配置。
确认使用的是本地管理员或服务账户，而不是 Ubiquiti SSO 云账户。
检查用户名、密码、站点名称和可选 API key 是否正确。
如果证书验证导致连接问题，检查 UNIFI_VERIFY_SSL 配置。
确认账户拥有执行目标网络操作所需的权限。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

显示 Guest VLAN 上所有客户端的信号强度和数据用量
创建一条防火墙规则，禁止 IoT 设备在凌晨 0 点到 6 点访问互联网
审计我的防火墙策略——有没有冗余或冲突的规则？
显示最近一小时最活跃的流量，按目标地址分组

使用场景

查询 UniFi 网络设备和客户端状态。

管理防火墙规则、VLAN 和 VPN。

查看访客 VLAN 客户端的信号强度和数据使用情况。

审计防火墙策略并分析网络流量。

支持客户端

Claude Desktop

Codex

OpenClaw

依据项目文档列出，未经本站实测。

详细介绍

UniFi Network MCP 是一个通过 MCP 管理 UniFi Network 控制器的独立开源服务器，可处理网络设备、客户端、防火墙、VLAN、VPN 等网络管理任务。该仓库还包含 Protect 和 Access 服务器；本资料仅描述 apps/network/server.json 对应的 Network 服务器。该服务器版本为 0.27.0，提供 189 个工具，使用 stdio 传输。

同仓库的其他 Server

源版本 fbd083c62ec8 数据同步于 2026-10-19 查看 FMRS 评分方法