unifi-mcp

概述

UniFi MCP 是一组 MCP 服务器，使 AI 助手能够与 Ubiquiti UniFi 控制器交互。该项目包含三个主要服务器：网络版（稳定，169个工具）、安防版（测试版，43个工具）和门禁版（测试版，29个工具）。每个服务器都将各自 UniFi 应用的功能作为 MCP 工具暴露，这些工具可查询、可组合且默认安全。项目还包含用于连接远程代理的云端中继，以及用于非 MCP 消费者的可选 REST/GraphQL API。

试试问 AI

装完之后，这里有 7 个你可以让 AI 做的事：

• show_clients

  Show all clients connected to the network with their details

  试试:Show me all clients on the Guest VLAN with their signal strength试试:List all connected devices with their data usage
• create_firewall_rule

  Create a new firewall rule to control network traffic

  试试:Create a firewall rule that blocks IoT devices from reaching the internet between midnight and 6 AM试试:Add a rule to allow management traffic only during business hours
• audit_firewall

  Audit firewall policies for redundant or conflicting rules

  试试:Audit my firewall policies — are there any redundant or conflicting rules?试试:Check for overlapping firewall rules that might cause security issues
• list_motion_cameras

  List all cameras that detected motion in a specified time period

  试试:List all cameras that detected motion in the last hour试试:Show me cameras with motion detection from yesterday
• show_smart_detection

  Show smart detection events from cameras with filtering options

  试试:Show me smart detection events from the front door camera today — people and vehicles only试试:List all person detection events from the back camera
• badge_access_events

  Show timeline of door access events and badge information

  试试:Who badged into the office today? Show me a timeline of all door access events试试:List all access events from the main entrance yesterday
• create_visitor_pass

  Create a visitor pass with specific access permissions

  试试:Create a visitor pass for John Smith with access to the main entrance tomorrow 9-5试试:Generate a temporary badge for the conference room with 24-hour access
• network_health_check

  Run batch diagnostics across devices and health subsystems

  试试:Run a network health check on all switches试试:Check the status of all access points and their connections
• firewall_manager

  Manage firewall policies with templates and change tracking

  试试:Apply the IoT security template to my firewall rules试试:Create a backup of my current firewall configuration
• security_digest

  Summarize cross-product events with severity classification

  试试:Generate a security digest for yesterday's events试试:Show me all high-severity events from cameras and doors
• correlate_events

  Correlate Network, Protect, and Access events in a single timeline

  试试:Show me everything that happened at the front entrance in the last hour试试:What network events occurred when the door was opened at 2 AM?
• audit_firewall_policies

  Comprehensive security audit of firewall policies with scoring

  试试:Perform a security audit of my firewall policies试试:Check my firewall configuration against best practices

可对比工具

安装

{
  "mcpServers": {
    "unifi-network": {
      "command": "uvx",
      "args": ["unifi-network-mcp@latest"],
      "env": {
        "UNIFI_HOST": "192.168.1.1",
        "UNIFI_USERNAME": "admin",
        "UNIFI_PASSWORD": "your-password"
      }
    },
    "unifi-protect": {
      "command": "uvx",
      "args": ["unifi-protect-mcp@latest"],
      "env": {
        "UNIFI_PROTECT_HOST": "192.168.1.1",
        "UNIFI_PROTECT_USERNAME": "admin",
        "UNIFI_PROTECT_PASSWORD": "your-password"
      }
    },
    "unifi-access": {
      "command": "uvx",
      "args": ["unifi-access-mcp@latest"],
      "env": {
        "UNIFI_ACCESS_HOST": "192.168.1.1",
        "UNIFI_ACCESS_USERNAME": "admin",
        "UNIFI_ACCESS_PASSWORD": "your-password"
      }
    }
  }
}

uvx unifi-network-mcp@latest
uvx unifi-protect-mcp@latest
uvx unifi-access-mcp@latest

FAQ

这需要 UniFi API 密钥吗？

不需要，默认使用用户名/密码认证。API 密钥是可选的且为实验性质，仅限于只读访问。

我可以用这个管理多个控制器吗？

可以，每个服务器都支持带前缀的环境变量，可以连接到不同的控制器或使用不同的凭据。

什么是预览然后确认流程？

在应用任何更改之前，MCP 工具会显示将要修改的确切内容，让您可以在更改生效前确认或拒绝它们。

unifi-mcp 对比