MCP 服务器 UniFi

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

特征

• 通过 AI 代理使用自然语言查询 UniFi 站点和设备

• 连接到您的 UniFi 网络应用程序的本地服务器实现

• 兼容 Goose AI 和 Claude Desktop

• 基于安全 API 密钥的身份验证

Related MCP server: UnifiyMe

先决条件

• 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 桌面设置

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"
            ]
        }
    }
}