Go Unifi MCP
G

Go Unifi MCP

一個用於 UniFi 網絡控制器的 MCP 服務器,提供對 UniFi 基礎設施(包括防火牆規則和 IPv6)的 AI 助手訪問接口,支持 API 密鑰和用戶名/密碼兩種認證方式。
2分
0

什麼是 go-unifi-mcp?

go-unifi-mcp 是一個連接 AI 助手與 UniFi 網絡設備的橋樑。它允許您通過自然語言或簡單的命令來管理您的 UniFi 網絡,無需登錄複雜的控制面板。

如何使用 go-unifi-mcp?

只需配置好您的 UniFi 控制器連接信息,然後在 Claude Desktop 或 Claude Code 中啟用此 MCP 服務器,您就可以直接詢問 AI 助手關於網絡狀態、設備信息,甚至執行管理操作。

適用場景

適合家庭用戶、小型企業管理員或任何使用 UniFi 網絡設備並希望通過 AI 助手簡化管理流程的用戶。特別適合快速查詢網絡狀態、設備列表、管理訪客網絡等日常任務。

主要功能

完整的 UniFi API 覆蓋
支持 242 個 UniFi 操作,涵蓋設備管理、網絡配置、防火牆規則、用戶管理等各個方面
智能工具模式
提供兩種工具註冊模式:Lazy 模式(推薦)僅註冊 3 個元工具,節省上下文空間;Eager 模式註冊所有工具,適合調試
ID 自動解析
自動將 API 返回的複雜 ID 轉換為易讀的名稱,讓響應更直觀易懂
靈活的查詢過濾
支持按字段過濾、全文搜索和字段投影,讓您精確獲取所需信息
多平臺支持
提供二進制文件、Docker 鏡像、Homebrew 和 Nix 包,支持 macOS 和 Linux 系統
IPv6 和防火牆規則支持
完整支持 IPv6 和 v1/v2 防火牆規則,滿足現代網絡需求
優勢
基於官方 go-unifi 庫開發,API 覆蓋全面且穩定
智能工具模式大幅減少 AI 助手的上下文佔用
ID 自動解析功能讓響應更易理解
支持多種安裝方式,部署簡單
持續更新,跟隨 UniFi 控制器版本演進
侷限性
需要 UniFi 控制器和相應的訪問權限
更新操作採用讀-修改-寫流程,非原子操作
某些高級功能可能需要技術背景理解
目前僅支持命令行和 AI 助手集成,無獨立 GUI

如何使用

獲取訪問憑證
在 UniFi 控制器中創建 API 密鑰(推薦)或準備管理員賬號密碼
安裝服務器
選擇適合您系統的安裝方式,如使用 Homebrew、Docker 或直接下載二進制文件
配置 Claude Desktop
編輯 Claude Desktop 配置文件,添加 MCP 服務器配置
開始使用
重啟 Claude Desktop,現在您可以直接詢問 AI 助手關於 UniFi 網絡的問題了

使用案例

快速網絡狀態檢查
當您想了解網絡整體狀態時,可以快速查詢設備信息和客戶端連接情況
訪客網絡管理
為訪客創建臨時網絡或管理現有訪客網絡
設備故障排查
當某個設備連接有問題時,快速查看其詳細信息和連接狀態
批量設備管理
對多個設備執行相同操作,如重啟、重命名或重新配置

常見問題

我需要什麼樣的 UniFi 控制器版本?
Lazy 模式和 Eager 模式有什麼區別?
API 密鑰和用戶名密碼哪種認證方式更好?
為什麼有時候響應中會有 _name 字段?
如何過濾查詢結果?
更新操作安全嗎?會不會覆蓋其他人的修改?

相關資源

GitHub 倉庫
項目源代碼、問題跟蹤和最新版本
go-unifi 庫
本項目依賴的 UniFi Go 客戶端庫
UniFi 官方文檔
UniFi 網絡設備的官方文檔和支持
Model Context Protocol
MCP 協議官方規範
Docker 鏡像
官方 Docker 鏡像倉庫

安裝

複製以下命令到你的Client進行配置
{
  "mcpServers": {
    "unifi": {
      "command": "/usr/local/bin/go-unifi-mcp",
      "env": {
        "UNIFI_HOST": "https://your-controller:443",
        "UNIFI_API_KEY": "your-api-key"
      }
    }
  }
}

{
  "mcpServers": {
    "unifi": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "UNIFI_HOST",
        "-e",
        "UNIFI_API_KEY",
        "ghcr.io/claytono/go-unifi-mcp:latest"
      ],
      "env": {
        "UNIFI_HOST": "https://your-controller:443",
        "UNIFI_API_KEY": "your-api-key"
      }
    }
  }
}
注意:您的密鑰屬於敏感信息,請勿與任何人分享。

替代品

M
Moltbrain
MoltBrain是一個為OpenClaw、MoltBook和Claude Code設計的長期記憶層插件,能夠自動學習和回憶項目上下文,提供智能搜索、觀察記錄、分析統計和持久化存儲功能。
TypeScript
5.1K
4.5分
B
Bm.md
一個功能豐富的Markdown排版工具,支持多種樣式主題和平臺適配,提供即時編輯預覽、圖片導出和API集成能力
TypeScript
4.4K
5分
S
Security Detections MCP
Security Detections MCP 是一個基於Model Context Protocol的服務器,允許LLM查詢統一的安全檢測規則數據庫,涵蓋Sigma、Splunk ESCU、Elastic和KQL格式。最新3.0版本升級為自主檢測工程平臺,可自動從威脅情報中提取TTPs、分析覆蓋差距、生成SIEM原生格式檢測規則、運行測試並驗證。項目包含71+工具、11個預構建工作流提示和知識圖譜系統,支持多SIEM平臺。
TypeScript
5.0K
4分
P
Paperbanana
PaperBanana是一個自動化生成學術圖表和統計圖的智能框架,支持從文本描述生成高質量的論文插圖,採用多智能體管道和迭代優化,提供CLI、Python API和MCP服務器等多種使用方式。
Python
6.6K
5分
R
Rsdoctor
Rsdoctor 是一款專為 Rspack 生態系統打造的構建分析工具,全面兼容 webpack,提供可視化構建分析、多維度性能診斷及智能優化建議,幫助開發者提升構建效率與工程質量。
TypeScript
9.3K
5分
N
Next Devtools MCP
Next.js開發工具MCP服務器,為Claude、Cursor等AI編程助手提供Next.js開發工具和實用程序,包括運行時診斷、開發自動化和文檔訪問功能。
TypeScript
9.7K
5分
T
Testkube
Testkube是一個面向雲原生應用的測試編排與執行框架,提供統一平臺來定義、運行和分析測試,支持現有測試工具和Kubernetes基礎設施。
Go
6.5K
5分
M
MCP Windbg
一個MCP服務器,將AI模型與WinDbg/CDB集成,用於分析Windows崩潰轉儲文件和進行遠程調試,支持自然語言交互執行調試命令。
Python
10.5K
5分
B
Baidu Map
已認證
百度地圖MCP Server是國內首個兼容MCP協議的地圖服務,提供地理編碼、路線規劃等10個標準化API接口,支持Python和Typescript快速接入,賦能智能體實現地圖相關功能。
Python
38.7K
4.5分
M
Markdownify MCP
Markdownify是一個多功能文件轉換服務,支持將PDF、圖片、音頻等多種格式及網頁內容轉換為Markdown格式。
TypeScript
31.3K
5分
F
Firecrawl MCP Server
Firecrawl MCP Server是一個集成Firecrawl網頁抓取能力的模型上下文協議服務器,提供豐富的網頁抓取、搜索和內容提取功能。
TypeScript
118.9K
5分
S
Sequential Thinking MCP Server
一個基於MCP協議的結構化思維服務器,通過定義思考階段幫助分解複雜問題並生成總結
Python
31.1K
4.5分
E
Edgeone Pages MCP Server
EdgeOne Pages MCP是一個通過MCP協議快速部署HTML內容到EdgeOne Pages並獲取公開URL的服務
TypeScript
25.0K
4.8分
M
Magic MCP
Magic Component Platform (MCP) 是一個AI驅動的UI組件生成工具,通過自然語言描述幫助開發者快速創建現代化UI組件,支持多種IDE集成。
JavaScript
19.3K
5分
N
Notion Api MCP
已認證
一個基於Python的MCP服務器,通過Notion API提供高級待辦事項管理和內容組織功能,實現AI模型與Notion的無縫集成。
Python
19.1K
4.5分
C
Context7
Context7 MCP是一個為AI編程助手提供即時、版本特定文檔和代碼示例的服務,通過Model Context Protocol直接集成到提示中,解決LLM使用過時信息的問題。
TypeScript
79.7K
4.7分
AIBase
智啟未來,您的人工智慧解決方案智庫
© 2026AIBase