MCP Server Unifi

🚀 UniFi 管理控制協議 (MCP) 服務器

UniFi 管理控制協議 (MCP) 服務器可用於管理和控制 UniFi 網絡設備。它通過 MCP（管理控制協議）連接到 UniFi 網絡，支持使用 AI 代理（如 Goose 和 Claude）以自然語言與 UniFi 網絡交互，同時封裝了 UniFi 網絡 API，為用戶提供便捷的網絡管理體驗。

✨ 主要特性

• 自然語言交互：可通過 AI 代理使用自然語言查詢 UniFi 站點和設備。
• 本地服務器：本地服務器實現，可連接到 UniFi 網絡應用程序。
• 多 AI 兼容：兼容 Goose AI 和 Claude Desktop。
• 安全認證：基於 API 密鑰的安全認證機制。

📦 安裝指南

先決條件

• Python 3.8 或更高版本
• uv 包管理器
• UniFi 網絡應用程序
• UniFi API 密鑰（從 UniFi 控制檯獲得）

安裝步驟

1. 創建 API 密鑰：
   • 訪問您的 UniFi 控制檯：https://unifi.ui.com
   • 轉到設置 » 控制平面 » 集成
   • 點擊“創建 API 密鑰”
2. 克隆並設置倉庫：

git clone https://github.com/zcking/mcp-server-unifi
cd mcp-server-unifi
uv venv
source .venv/bin/activate  # Unix/macOS 系統
# 或者
.venv\Scripts\activate  # Windows 系統

3. 安裝依賴項：

uv sync

4. 配置環境變量：

export UNIFI_API_KEY="your_api_key_here"

💻 使用示例

啟動服務器

啟動 MCP 開發服務器：

uv run mcp dev main.py

MCP 檢查工具將在 http://localhost:5173 可用，用於測試和調試。

AI 代理集成

Goose AI 設置

1. 打開 Goose 並轉到設置 » 擴展 » 添加自定義擴展。
2. 配置擴展：
   • ID: unifi
   • 名稱: unifi
   • 描述: 獲取有關您的 UniFi 網絡的信息
   • 命令: /Users/username/.local/bin/uv --directory /path/to/mcp-server-unifi run main.py
   • 環境變量: 設置 UNIFI_API_KEY 為您的 API 密鑰

Claude Desktop 設置

1. 打開 Claude 並轉到設置 » 開發者 » 編輯配置。
2. 將以下內容添加到 claude_desktop_config.json：

{
    "mcpServers": {
        "unifi": {
            "command": "/Users/username/.local/bin/uv",
            "args": [
                "--directory",
                "/path/to/mcp-server-unifi",
                "run",
                "main.py"
            ]
        }
    }
}