sirkirby/unifi-mcp

解決的問題

UniFi MCP 允許 AI 助手與自動化工具與 Ubiquiti UniFi 控制器互動。它彌合了自然語言介面與複雜網路基礎設施管理之間的差距，讓使用者能透過 AI 代理查詢、審計與修改其 UniFi Network、Protect 與 Access 部署。

工作原理

此專案實作 Model Context Protocol (MCP)，將 UniFi 控制器功能以一組可查詢且可組合的工具形式公開。它由多個專用伺服器（網路、Protect 與 Access）組成，透過管理員帳戶連接到本地控制器。

針對遠端存取，它使用「Cloud Relay」系統：由 Cloudflare 主機的 Worker 網關扮演經過驗證的邊緣端點，透過 WebSocket 與本地 Relay 邊車通訊，將請求轉送至本地 MCP 伺服器。同時也包含獨立的 REST 與 GraphQL API 伺服器，供非 MCP 消費者使用。

適用對象

專為使用 UniFi 硬體，並希望透過 AI 驅動的代理（如 Claude Code、Codex 或 OpenClaw）而非手動瀏覽儀表板來管理其基礎設施的網路管理員與家庭實驗室愛好者所設計。

主要亮點

• 全面的工具集：涵蓋網路（192 個）、Protect（61 個）與 Access（36 個）領域的數百個工具。
• 代理技能：包含預先定義的技能，用於執行複雜任務，如網路健康檢查、100 分制的防火牆審計與安全摘要。
• 安全為先：所有變更操作均採用「預覽-確認」流程，並自動從代理上下文中隱藏敏感欄位（如 Wi-Fi 密碼與 VPN 金鑰）。
• 彈性部署：支援本地直接執行、AI IDE 插件式安裝，以及用於遠端管理的雲端中繼架構。