M
MCP 精选目录 CURATED DIRECTORY
已收录 911 个 MCP Server
EN
← 返回目录
U

UniFi Access MCP

社区
通过 MCP 管理 UniFi Access 门禁系统。
查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗
分类
其他 第 64 / 230
Stars
★ 921 非常热门
传输方式
stdio（本地进程）
运行环境
Python 3.13+
凭据
需要 API Key / 凭据
许可证
MIT
最近提交
61FMRS · C

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

最强项 · 安全与权限 14/20 最弱项 · 可靠性 9/20

可靠性
9/20
安全与权限
14/20
维护活跃度
13/20
文档质量
12/20
安装易用性
13/20
查看各项评分依据
可靠性 9/20
清单声明了可通过 PyPI 以 stdio 启动，根 README 将 Access 标为 Stable 并声明 36 个工具，启动路径在静态层面合理。但未提供 apps/access/server.json 对应的源码、工具定义、错误处理、CI 或服务器专属测试证据，因此无法验证初始化、工具列表与实际行为的一致性；按静态校准扣分。
安全与权限 14/20
证据显示凭据环境变量被标记为 secret，默认启用敏感字段脱敏，且所有变更采用预览后确认流程；访问范围也限定为本地 UniFi 控制器。扣分原因是 UNIFI_VERIFY_SSL 默认 false，服务器要求管理员用户名和密码，API key 仍标为 experimental，且未提供 Access 服务器专属的最小权限、审计或网络数据边界证据。
维护活跃度 13/20
仓库未归档，许可证为 MIT，服务器版本为 0.5.6，README 将 Access 标为 Stable，且公开列出维护相关的 issues 数量。这支持持续维护的基本判断。未提供提交频率、发布历史、依赖更新策略、漏洞响应渠道或 Access 专属维护证据，因此不能接近满分。
文档质量 12/20
根 README 提供了服务器划分、Access 能力概述、安装命令、客户端配置示例、账户要求、环境变量、脱敏说明和预览确认说明，内容较完整。扣分原因是 Access 的详细文档仅以链接形式出现，提示的工具参数、限制、故障排查和实际行为在给定材料中不可复核；README 还包含多个兄弟服务器和组件的信息，不能将其全部归属于 Access。
安装易用性 13/20
提供了 uvx 直接运行方式，以及 Claude Desktop、Codex 和 OpenClaw 的配置示例，并说明了必需的本地账户和环境变量，主流客户端接入路径清晰。扣分原因是仍需手工创建本地账户和配置凭据，默认关闭 SSL 校验，且未提供平台兼容性、依赖失败处理或 Access 专属安装验证证据；静态审查下不超过 15 分。

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

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

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

不适合谁

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

所需权限

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

风险与副作用

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

安装接入

准备工作

运行环境：Python 3.13+

UNIFI_ACCESS_HOST 必填 UniFi Access 控制器的 IP 或主机名，使用本地控制器地址。
UNIFI_ACCESS_USERNAME 必填密钥 本地管理员/服务账号用户名，勿使用 Ubiquiti SSO 云账号。
UNIFI_ACCESS_PASSWORD 必填密钥 该本地账号的密码。
UNIFI_ACCESS_API_KEY 可选密钥 可选的 UniFi API key，用于部分实验性功能，在控制器中生成。
UNIFI_USERNAME 可选密钥 共享回退变量：本地管理员用户名。
UNIFI_PASSWORD 可选密钥 共享回退变量：本地管理员密码。
UNIFI_API_KEY 可选密钥 共享回退变量：可选 API key。
其他可选配置项（9 个）
UNIFI_ACCESS_PORT 可选 控制器 HTTPS 端口，默认 443。
UNIFI_ACCESS_VERIFY_SSL 可选 是否校验 SSL 证书，默认 false。
UNIFI_HOST 可选 共享回退变量：控制器 IP 或主机名（Access 服务器优先使用 UNIFI_ACCESS_*）。
UNIFI_PORT 可选 共享回退变量：控制器 HTTPS 端口。
UNIFI_VERIFY_SSL 可选 共享回退变量：SSL 证书校验开关。
UNIFI_ACCESS_MCP_CONTENT_MODE 可选 覆盖该服务器的响应内容模式（compat 或 compact）。
UNIFI_MCP_CONTENT_MODE 可选 全局响应内容模式，compat 保留完整 JSON，compact 使用精简文本加 structuredContent。
UNIFI_ACCESS_REDACT_SENSITIVE_FIELDS 可选 设为 false 可在本服务器禁用敏感字段（如凭证 token/PIN）脱敏。
UNIFI_REDACT_SENSITIVE_FIELDS 可选 全局敏感字段脱敏开关，默认开启。

使用 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"}}}}

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

.vscode/mcp.json
{
  "servers": {
    "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"
      }
    }
  }
}

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

Terminal
claude mcp add unifi-access -e UNIFI_ACCESS_HOST=192.168.1.1 -e UNIFI_ACCESS_USERNAME=admin -e UNIFI_ACCESS_PASSWORD=your-password -- uvx unifi-access-mcp@latest

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

生成并校验客户端配置

验证是否装好

用 uvx unifi-access-mcp@latest 启动并配置 UNIFI_ACCESS_HOST/USERNAME/PASSWORD 后，在 MCP 客户端运行 tools/list 确认 UniFi Access 工具已注册，然后询问“谁今天刷卡进入了办公室？”验证能否返回真实的门禁事件。

常见排障

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

试试这样问

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

  • 谁今天刷卡进入了办公室？给我显示所有门禁事件的完整时间线
  • 为 John Smith 创建一个访客通行证，明天 9-5 可进入主入口
  • 列出 UniFi Access 中配置的所有门和凭证
  • 显示今天的门禁事件，并总结异常活动

使用场景

查询门禁事件和访客活动。
管理门、凭证和访问策略。
创建或管理访客通行安排。
让 AI 助手协助处理 UniFi Access 门禁管理。

支持客户端

Claude Desktop
Codex
OpenClaw

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

详细介绍

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

同类可选方案

BioMCP 75 · B

统一的命令行语法，接入约30个可信生物医学数据源。

★ 659 · 工具数 11 与当前对比 →
与其他 MCP 横向对比

同仓库的其他 Server

UniFi Network MCPUniFi Protect MCP

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