MCP Server UniFi

基本能力

产品定位

MCP Server UniFi 是一个用于管理和控制UniFi网络设备的服务器实现，通过AI代理实现自然语言交互。

核心功能

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

适用场景

• 通过自然语言管理UniFi网络设备
• 与AI代理集成实现自动化网络管理

工具列表

• uv 包管理器：用于依赖管理和运行服务器
• UniFi Network 应用：提供网络管理和API支持

常见问题解答

• 如何获取API密钥？ 从UniFi控制台的设置 > 控制平面 > 集成中创建API密钥。
• 如何启动服务器？ 使用命令 uv run mcp dev main.py 启动开发服务器。

使用教程

使用依赖

• Python 3.8或更高版本
• uv 包管理器
• UniFi Network 应用
• UniFi API密钥

安装教程

1. 创建API密钥：
2. 访问UniFi控制台 https://unifi.ui.com
3. 导航到设置 > 控制平面 > 集成

4. 点击“创建API密钥”

5. 克隆并设置仓库：

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上

1. 安装依赖：

uv sync

1. 配置环境变量：

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. 配置扩展：
3. ID: unifi
4. 名称: unifi
5. 描述: 获取关于UniFi网络的信息
6. 命令: /Users/username/.local/bin/uv --directory /path/to/mcp-server-unifi run main.py
7. 环境变量: 设置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"
            ]
        }
    }
}

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。