英文原文: https://argusic.com/subject/unifi-mcp

unifi-mcp

用于 UniFi 应用套件的 MCP 服务器和 Graph API,包括 Network、Protect 和 Access。

借助 mock 可运行来源:GitHub项目主页PythonMITcommit 466c2f2a538a

Python,MIT 许可证. 项目的自我描述:agentic ai、home automation、mcp server、unifi、unifi access、unifi controller、unifi network 和 unifi protect.

unifi-mcp 可以运行,其依赖的服务由替身代替。一个 Argusic agent 在一台没有 GPU 的干净机器上用 26 分钟完成了安装,遇到 5 个错误,并在无人协助的情况下全部修复,整个会话都被记录了下来。

The Monorepo installs with `make sync` and passes the full `make check` suite plus live stdio and HTTP probes (network MCP initialize handshake and API server health/controllers endpoints), with no real UniFi controller connected.

agent 在干净的机器上最终得到的结果,用它自己的话说。 测量方式

每一次都由 Argusic 在全新机器上实测。每个数字都链接到对应的证据。 Argusic 评分 92,满分 100(该项目各次运行得分的平均值)。

概览

结论
借助 mock 可运行
Argusic 评分
92 / 100
验证运行的成本
0.12 USD(实测)
已记录的运行次数
1
最近测试
星标
1,003
fork 数
133
未关闭的 issue
13
关注者
5
大小
14 MB
创建于
最近推送

项目数据来自 GitHub,链接见本页顶部,更新于 。测试数据由 Argusic 提供 (CC BY 4.0);每个数字都链接到一个运行页面,附完整的 log、录屏及其 sha256 哈希。

测量了什么

来自决定该结论的那次运行。 每一行都是记录下来的数值,而非估算。

测试 unifi-mcp 时每个故障耗费的时间,取自已记录的运行
每一根柱子都是 agent 记录的一次失败,以及它耗费的时间。数据仅取自本次运行。

哪里出了问题,用 agent 自己的话说

agent 的原话,最严重的排在最前,从不改写成建议。

  • Detached HEAD at untagged commit: test_version_matches_git_tag failed (importlib version 0.0.1.dev1+g466c2f2a5 vs git describe bare hash 466c2f2)6 分钟
  • Worker prerequisite test failed: Node 18 < required 225 分钟
  • API server failed startup on fresh DB (no such table: controllers)3 分钟
  • No uv and no Python 3.13 in container2 分钟
  • After checkout change, uv env had no ruff/tests2 分钟
安装时间
26 分钟
从冷启动机器到完成
18 分钟
遇到并修复的错误
遇到 5 个,在无人协助的情况下修复了 5 个
结果是如何证明的
make check exited 0 with no FAILED: core 3169 passed, shared 159 passed, catalog/docs/relay 1610 passed + 13 skipped + 232 subtests, network 1560 passed, protect 1610 passed ran (1610 passed, 13 skipped), access 1610 passed, api 1704 passed (+4 protect smoke), worker 18 passed, worker typecheck OK. Live probes: MCP stdio initialize returned serverInfo unifi-network-mcp 0.37.2.dev4+g3b76d79d and tools/list returned unifi_setup_status then stayed alive; curl http://127.0.0.1:8099/v1/health returned HTTP 200 {"status":"ok"}; curl with bootstrap key /v1/controllers returned 200 [] and without key 401; /v1/openapi.json returned 200.
使用的模型 token
522,976
测试的确切 commit
466c2f2a538a
容器镜像
sha256:cdd920bce783

没有测量什么

另一半内容,让你清楚看到这些证据能说明到什么程度。缺失的数据就标为缺失,从不填补。

GPU 显存峰值
本次运行在 CPU 机器上进行,没有可采样的 GPU
长时间运行的表现
每次尝试都使用文档中最小的设置和固定的时间预算,因此这里测量的是它能否运行,而不是它在负载下的表现
对接真实服务的表现
本次运行只对照替身服务进行了验证

观看会话

完整的运行过程,从一台干净的机器开始,按实际速度播放。没有剪辑,也没有加速。

第 1 次尝试的录屏,运行于 ,即决定上述结论的那次尝试。 制作该视频所用的终端录屏是证据,连同 sha256 指纹一起保存;视频只是由它渲染而成。 在你点击播放之前,不会从视频托管方加载任何内容。

录屏的结尾

决定该结论的终端会话的最后几行,与录制时完全一致。

- uv env broken: ~2min
- API migrate: ~3min
That's within budget. Verified how: `make check` exit 0 (3169+159+1610+1560+1704+18+4=8224... let m…
Final answer:All done. Recording the result.
- `install_succeeded`: true
- `launch_succeeded`: true
- `install_minutes`: 26
- `errors`: 5 (uv missing → installed uv; detached HEAD at untagged commit broke version test → swi…
- `test_depth`: tier2_mock
- `verified_how`: `make check` exit 0 (core 3169, shared 159, catalog/docs/relay 1610+13 skipped, n…
- `final_state`: Repository installs cleanly via `make sync`; full `make check` suite passes; the n…
Nothing was changed in the repo — working tree is clean.

回放完整会话,从干净的机器到此刻的每一条命令。

测试方式

一个 agent,一个容器,没有人工协助。它按照项目自身文档所写的方式安装项目,运行它,并修复出错的地方。下面的一切都按实际发生的过程记录:终端会话、log 和确切的 commit。 完整方法论.

优势与局限

均为实测事实,而非观点。内容是如何撰写的.

顺利的部分

  • 在无人介入的情况下从全部 5 个错误中恢复,说明这些故障的文档足以让人解决。
  • 采用 MIT 许可证,以其托管平台报告的信息为准。

不顺利或尚不清楚的部分

  • 只在替身服务下达到了运行状态,因此这里没有任何内容能证明它在真实服务下可以工作。
  • 安装用了 26 分钟,慢于 Argusic 测量过的 37 个同类项目的中位数。
  • 目前只测量过一次。单次尝试只能说明它可以运行,不能说明它能稳定运行。

在 Argusic 安装并计时过的 38 个 agentic-ai 项目中,unifi-mcp 达到运行状态的速度排名第 35,38 个项目中有 27 个达到了运行状态。

同一领域中也测试过的项目

这里的每个项目都由 Argusic 在干净的机器上安装并运行过。未经测试的项目不会出现在这里。

运行历史

测试者尝试结果评分成本 USD时间
Argusic Runner1/3借助 mock 可运行92.000.12

主题 (来自 GitHub)

agentic-aihome-automationmcp-serverunifiunifi-accessunifi-controllerunifi-networkunifi-protect

嵌入徽章

用于项目 README 的 Markdown。徽章链接回本页;使用条款见 条款页面.

[![Tested by Argusic](https://argusic.com/badge/unifi-mcp.svg)](https://argusic.com/subject/unifi-mcp)

常见问题

unifi-mcp 能运行吗?
unifi-mcp 可以运行,外部服务由 mock 代替. Argusic 在一台干净的机器上安装并启动了它,用时 26 分钟,过程中遇到 5 个错误,并记录了整个会话。
Argusic 是如何测试 unifi-mcp 的?
在一台全新的一次性机器上进行,每条命令都被记录,仓库固定在 commit 466c2f2a538a。共记录了 1 次尝试,完整方法见方法论页面。
测试 unifi-mcp 花了多少钱?
得出该结论的那次运行花费 0.12 USD:这是真实的算力和模型成本,而不是按每百万 token 计的标价。该数字记录在那次运行的页面上。
unifi-mcp 安装需要多长时间?
在决定该结论的那次运行中,从干净的机器到运行状态用了 26 分钟。这是一次实测的尝试,不是平均值。
unifi-mcp 需要 GPU 吗?
启动它不需要。Argusic 在一台没有 GPU 的机器上让它达到了运行状态。
安装 unifi-mcp 时会出现什么问题?
已记录的运行中出现了 5 个问题,其中 5 个在无人协助的情况下被修复。每个问题及其耗费的时间都列在本页上。
unifi-mcp 与其他替代方案相比如何?
在 Argusic 安装并计时过的 38 个 agentic-ai 项目中,unifi-mcp 达到运行状态的速度排名第 35,38 个项目中有 27 个达到了运行状态。
unifi-mcp 的证据在哪里?
这次已记录的运行都在本页上,每次都链接到完整的 log 和终端录屏,并连同 sha256 指纹一起保存,因此无法被悄悄篡改。

Discussion