MCP Server UniFi

一个用于通过 MCP (管理控制协议) 管理和控制 UniFi 网络设备的服务器实现。该服务器通过封装 UniFi Network API，使您能够使用 Goose 和 Claude 等 AI 代理以自然语言与您的 UniFi 网络进行交互。

功能

• 使用 AI 代理通过自然语言查询 UniFi 站点和设备
• 连接到您的 UniFi Network 应用程序的本地服务器实现
• 兼容 Goose AI 和 Claude Desktop
• 安全的基于 API 密钥的身份验证

前提条件

• Python 3.8 或更高版本
• uv 包管理器
• UniFi Network 应用程序
• UniFi API 密钥（从 UniFi 控制台获取）

设置

1. 创建 API 密钥：

   • 转到您的 UniFi 控制台，地址为 https://unifi.ui.com
   • 导航到 Settings » Control Plane » Integrations
   • 点击 "Create API Key"

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 Inspector 将在 http://localhost:5173 上可用，用于测试和调试。

AI 代理集成

Goose AI 设置

1. 打开 Goose 并转到 Settings » Extensions » Add custom extension
2. 配置扩展：
   • ID: unifi
   • Name: unifi
   • Description: 获取有关您的 UniFi 网络的信息
   • Command: /Users/username/.local/bin/uv --directory /path/to/mcp-server-unifi run main.py
   • Environment Variables: 将 UNIFI_API_KEY 设置为您的 API 密钥

Claude Desktop 设置

1. 打开 Claude 并转到 Settings » Developer » Edit Config
2. 添加到您的 claude_desktop_config.json：

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