UniFi Network MCP Server

UniFi网络MCP服务器

模型上下文协议（MCP）服务器 UniFi网络API通过Claude等人工智能助手管理您的UniFi网络基础设施。

快速安装

curl -fsSL https://raw.githubusercontent.com/Ruashots/unifi-network-mcp/master/install.sh | bash

这将：

• 将存储库克隆到 ~/.local/share/unifi-network-mcp
• 安装依赖项并构建
• 提示输入UniFi控制台URL和API密钥
• 自动配置Claude代码

其他命令：

# Reconfigure credentials
~/.local/share/unifi-network-mcp/install.sh --reconfigure

# Uninstall
~/.local/share/unifi-network-mcp/install.sh --uninstall

特性

50+工具 涵盖完整的UniFi网络API：

• 站点 -列出API密钥可访问的所有站点
• 设备 -列出、获取统计数据、采用、重启、定位设备
• 客户 -查看已连接的客户端，授权访客访问
• 网络 -网络配置的完整CRUD
• 无线网络 -使用安全设置创建和管理SSID
• 热点优惠券 -生成和管理客人优惠券
• 防火墙区域 -将网络组织到安全区域
• ACL规则 -使用调度创建和管理防火墙规则
• 流量匹配列表 -IP组、端口组、域、应用程序、区域

先决条件

• Node.js 18+
• 带网络应用程序的UniFi控制台（UniFi操作系统控制台、云密钥或自托管）
• UniFi API密钥（站点管理员或超级管理员角色）
• jq （用于自动克劳德代码配置）

获取UniFi API密钥

1. 登录您的UniFi控制台
2. 点击您的个人资料图标（左下角）
3. 首选 API 部分
4. 点击 创建API密钥
5. 复制密钥（仅显示一次）

注： 您的API密钥将继承您的用户权限。使用站点管理员或超级管理员帐户进行完全访问。

手动安装

# Clone the repository
git clone https://github.com/Ruashots/unifi-network-mcp.git
cd unifi-network-mcp

# Install dependencies
npm install

# Build
npm run build

用法

Claude 代码命令行界面

claude mcp add unifi-network \
  --transport stdio \
  -e UNIFI_API_KEY="your-api-key" \
  -e UNIFI_BASE_URL="https://your-console-ip" \
  -- node /path/to/unifi-network-mcp/dist/index.js

范围选项：

克劳德桌面版

添加到您的Claude Desktop配置文件中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json Linux： ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "unifi-network": {
      "command": "node",
      "args": ["/path/to/unifi-network-mcp/dist/index.js"],
      "env": {
        "UNIFI_API_KEY": "your-api-key",
        "UNIFI_BASE_URL": "https://your-console-ip"
      }
    }
  }
}

环境变量

可用工具

应用

站点

设备

客户

网络

无线网络

热点优惠券

防火墙区域

ACL规则（防火墙）

流量匹配列表

配套资源

示例提示

配置后，使用自然语言：

"List all my UniFi sites"

"What devices are connected to my network?"

"Create a guest WiFi network with WPA3 security"

"Show me which clients are currently connected"

"Create 10 hotspot vouchers valid for 24 hours"

"Block traffic from the IoT network to the main network"

"Restart the access point in the living room"

"What's the current status of my UDM Pro?"

发展

npm install      # Install dependencies
npm run dev      # Run in development mode
npm run build    # Build for production
npm run watch    # Watch mode

API端点

MCP服务器连接到UniFi网络集成API，地址：

{UNIFI_BASE_URL}/proxy/network/integration/v1/...

这是UniFi Network 9.0+中引入的官方公共API。

安全

• 确保API密钥的安全，并且永远不要将其提交给版本控制
• 使用环境变量进行敏感配置
• API密钥继承用户权限-使用最小权限原则
• 考虑为自动化创建一个专门的API用户

许可证

麻省理工学院

链接

• UniFi开发者门户
• UniFi Network API文档
• 模型上下文协议