Go Unifi MCP
G

Go Unifi MCP

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

什麼是 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"
      }
    }
  }
}
注意:您的密鑰屬於敏感信息,請勿與任何人分享。

替代品

V
Vestige
Vestige是一個基於認知科學的AI記憶引擎,通過實現預測誤差門控、FSRS-6間隔重複、記憶夢境等29個神經科學模塊,為AI提供長期記憶能力。包含3D可視化儀表板和21個MCP工具,完全本地運行,無需雲端。
Rust
10.7K
4.5分
M
Moltbrain
MoltBrain是一個為OpenClaw、MoltBook和Claude Code設計的長期記憶層插件,能夠自動學習和回憶項目上下文,提供智能搜索、觀察記錄、分析統計和持久化存儲功能。
TypeScript
11.2K
4.5分
B
Bm.md
一個功能豐富的Markdown排版工具,支持多種樣式主題和平臺適配,提供即時編輯預覽、圖片導出和API集成能力
TypeScript
17.1K
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
9.0K
4分
P
Paperbanana
PaperBanana是一個自動化生成學術圖表和統計圖的智能框架,支持從文本描述生成高質量的論文插圖,採用多智能體管道和迭代優化,提供CLI、Python API和MCP服務器等多種使用方式。
Python
8.9K
5分
B
Better Icons
一個提供超過20萬圖標搜索和檢索的MCP服務器和CLI工具,支持150多個圖標庫,幫助AI助手和開發者快速獲取和使用圖標。
TypeScript
10.7K
4.5分
A
Assistant Ui
assistant-ui是一個開源TypeScript/React庫,用於快速構建生產級AI聊天界面,提供可組合的UI組件、流式響應、無障礙訪問等功能,支持多種AI後端和模型。
TypeScript
10.0K
5分
A
Apify MCP Server
Apify MCP服務器是一個基於模型上下文協議(MCP)的工具,允許AI助手通過數千個現成的爬蟲、抓取器和自動化工具(Apify Actor)從社交媒體、搜索引擎、電商等網站提取數據。它支持OAuth和Skyfire代理支付,可通過HTTPS端點或本地stdio方式集成到Claude、VS Code等MCP客戶端中。
TypeScript
10.1K
5分
B
Baidu Map
已認證
百度地圖MCP Server是國內首個兼容MCP協議的地圖服務,提供地理編碼、路線規劃等10個標準化API接口,支持Python和Typescript快速接入,賦能智能體實現地圖相關功能。
Python
43.8K
4.5分
M
Markdownify MCP
Markdownify是一個多功能文件轉換服務,支持將PDF、圖片、音頻等多種格式及網頁內容轉換為Markdown格式。
TypeScript
36.1K
5分
F
Firecrawl MCP Server
Firecrawl MCP Server是一個集成Firecrawl網頁抓取能力的模型上下文協議服務器,提供豐富的網頁抓取、搜索和內容提取功能。
TypeScript
144.9K
5分
S
Sequential Thinking MCP Server
一個基於MCP協議的結構化思維服務器,通過定義思考階段幫助分解複雜問題並生成總結
Python
35.7K
4.5分
E
Edgeone Pages MCP Server
EdgeOne Pages MCP是一個通過MCP協議快速部署HTML內容到EdgeOne Pages並獲取公開URL的服務
TypeScript
26.2K
4.8分
N
Notion Api MCP
已認證
一個基於Python的MCP服務器,通過Notion API提供高級待辦事項管理和內容組織功能,實現AI模型與Notion的無縫集成。
Python
21.0K
4.5分
C
Context7
Context7 MCP是一個為AI編程助手提供即時、版本特定文檔和代碼示例的服務,通過Model Context Protocol直接集成到提示中,解決LLM使用過時信息的問題。
TypeScript
93.3K
4.7分
M
Magic MCP
Magic Component Platform (MCP) 是一個AI驅動的UI組件生成工具,通過自然語言描述幫助開發者快速創建現代化UI組件,支持多種IDE集成。
JavaScript
22.7K
5分
AIBase
智啟未來,您的人工智慧解決方案智庫
© 2026AIBase