← 返回目录

UniFi Access MCP

社区

通过 MCP 管理 UniFi Access 门禁系统。

GitHub 源仓库 ↗

★ 749 Stars 分类 · 其他非常热门源版本 eb06c7141030

61FMRS · C

可靠性

9/20

安全与权限

14/20

维护活跃度

13/20

文档质量

12/20

安装易用性

13/20

源材料显示该服务器版本为 0.5.6，包名为 unifi-access-mcp，许可证为 MIT，提供 36 个 Access 工具，但未给出具体工具标识符。

查看 FMRS 评分方法 →

UniFi Access MCP 是一个以 stdio 运行的 MCP 服务器，用于通过 UniFi 控制器管理 UniFi Access 的门、凭证、访问策略、访客和事件。它属于独立开源项目，并非 Ubiquiti 官方服务器。

工具能力

暂未整理工具清单。

安装接入

使用 uvx 运行 unifi-access-mcp@latest，并配置 UNIFI_HOST、UNIFI_USERNAME 和 UNIFI_PASSWORD。UNIFI_PORT 默认为 443，UNIFI_VERIFY_SSL 默认为 false；也可以使用可选的 UNIFI_API_KEY。应使用本地管理员或服务账户，不要使用 Ubiquiti SSO 云账户。服务器也支持对应的 UNIFI_ACCESS_* 环境变量，并优先使用这些变量。

claude_desktop_config.json

{"mcpServers":{"unifi-access":{"command":"uvx","args":["unifi-access-mcp@latest"],"env":{"UNIFI_ACCESS_HOST":"192.168.1.1","UNIFI_ACCESS_USERNAME":"admin","UNIFI_ACCESS_PASSWORD":"your-password"}}}}

生成并校验客户端配置

选型与风险

适合谁

使用 UniFi Access 的家庭自动化或小型组织管理员。
需要通过 AI 助手查询和管理本地 UniFi Access 控制器的用户。
能够维护本地 UniFi 管理员或服务账户的部署。

不适合谁

只使用 Ubiquiti SSO 云账户、无法提供本地控制器账户的用户。
需要 Network 或 Protect 功能的用户；这些属于仓库中的其他服务器。
不希望 AI 工作流接触门禁、凭证或访客数据的环境。

所需权限

需要 UniFi 控制器 IP 地址或主机名。
需要本地 UniFi 管理员或服务账户用户名和密码。
账户应具备执行所需门禁管理操作的权限。
可选使用 UniFi API 密钥；源材料将其标记为实验性。

风险与副作用

门禁、凭证和访客管理可能影响实际物理访问权限。
控制器凭证和 API 密钥属于敏感信息，应妥善保护。
UNIFI_VERIFY_SSL 默认值为 false，可能降低 TLS 证书验证保护。
错误的账户权限或操作请求可能导致不必要的门禁配置变更。

常见排障

确认 UNIFI_HOST 指向正确的 UniFi 控制器，并检查 HTTPS 端口；默认端口为 443。
确认使用的是本地管理员或服务账户，而不是 Ubiquiti SSO 云账户。
检查用户名和密码是否正确，并确认账户具备所需权限。
如果使用特定服务器配置，确认 UNIFI_ACCESS_* 变量名称和值正确。
检查 SSL 验证设置；使用自签名证书时核对 UNIFI_VERIFY_SSL 配置。
确认已安装并运行 unifi-access-mcp@latest 对应的 PyPI 包。

使用场景

查询门禁事件和访客活动。

管理门、凭证和访问策略。

创建或管理访客通行安排。

让 AI 助手协助处理 UniFi Access 门禁管理。

支持客户端

Claude Desktop完整支持

Codex完整支持

OpenClaw完整支持