MCP Server UniFi

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

特性

• 通过AI代理使用自然语言查询UniFi站点和设备
• 连接到您的UniFi网络应用的本地服务器实现
• 兼容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  # On Unix/macOS
# or
.venv\Scripts\activate  # On 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": {
            "command": "/Users/username/.local/bin/uv",
            "args": [
                "--directory",
                "/path/to/mcp-server-unifi",
                "run",
                "main.py"
            ]
        }
    }
}