MCP 服务器 UniFi

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

特征

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

Related MCP server: MCP Server

先决条件

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

设置

创建 API 密钥：
- 前往您的 UniFi 控制台https://unifi.ui.com
- 导航至“设置”»“控制平面”»“集成”
- 点击“创建 API 密钥”
克隆并设置存储库：

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

安装依赖项：

uv sync

配置环境变量：

export UNIFI_API_KEY="your_api_key_here"

运行服务器

启动 MCP 开发服务器：

uv run mcp dev main.py

MCP Inspector 可在http://localhost:5173上进行测试和调试。

AI代理集成

Goose AI 设置

打开 Goose 并转到“设置”»“扩展”»“添加自定义扩展”
配置扩展：
- ID：unifi
- 名称：unifi
- 描述：获取有关您的 UniFi 网络的信息
- 命令： /Users/username/.local/bin/uv --directory /path/to/mcp-server-unifi run main.py
- 环境变量：将 UNIFI_API_KEY 设置为您的 API 密钥

Claude 桌面设置

打开 Claude 并转到设置»开发者»编辑配置
添加到您的claude_desktop_config.json ：

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