UniFi Safe MCP

一个专注的、只读的 UniFi Network MCP 服务器，提供有界的健康、设备和活动客户端视图。提取自 spectrenet-mcp 提交 2e63f009d8f4642e17398685baef0251811d6637；此仓库是自包含的。

安全契约

• 恰好三个只读工具：network_health、devices 和 clients；没有配置、命令、采用、重启、阻止或其他变更工具。

• 设备数据请求仅使用 HTTP GET（身份验证必然使用 POST /api/auth/login）。

• 默认启用 TLS 证书和主机名验证。

• 拒绝身份验证和设备数据重定向，而不是跟随。

• 配置的站点编码为一个 URL 路径段，端点后缀采用封闭白名单。

• HTTP 响应字节、返回列表长度、投影字段和审计字段均有界。

• 不审计凭据和完整响应。

Related MCP server: UniFi MCP Server

兼容性

这针对 UniFi OS 控制台代理路径 /api/auth/login 和 /proxy/network/api/s/{site}/...，在现代 UniFi OS 设备上观察到。较旧的自托管 UniFi Network Controller 通常使用 /api/login 和非代理的 /api/s/...；这些不受支持。Ubiquiti 在设备和 Network Application 版本之间更改私有/内部端点。没有经过认证的版本矩阵：在非生产环境中，针对您的确切控制台固件和 Network Application 版本测试此 alpha 版本，并在操作上固定升级。

安装和运行

uv sync --extra test
uv run unifi-safe-mcp --help
uv run unifi-safe-mcp

服务器使用 MCP stdio，不加载 .env。将 .env.example 仅视为虚假文档；通过监督者/密钥管理器注入专用的只读账户。

验证

uv sync --locked --extra test
uv run --locked pytest
uv run --locked python -m compileall -q src tests
uv build

参见 架构、兼容性 和 安全性。MIT © 2026 Ben Gauger.