MCP Server UniFi

这是一个通过MCP（管理控制协议）管理和控制UniFi网络设备的服务器实现。该服务器允许使用AI代理（如Goose和Claude）与您的UniFi网络进行自然语言交互，通过封装UniFi Network API来实现。

功能

• 使用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
   • 导航到设置 » 控制平面 » 集成
   • 点击“创建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 Inspector将在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": {
            "命令": "/Users/username/.local/bin/uv",
            "参数": [
                "--directory",
                "/path/to/mcp-server-unifi",
                "run",
                "main.py"
            ]
        }
    }
}