sirkirby/unifi-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

956 stars 133 forks 质量 86 趋势 45MIT

Repository Install

UniFi 应用套件 Network、Protect、Access 和 Drive 的 MCP 服务器

概览

利用代理和代理AI工作流程管理您的UniFi部署。 Cloud Relay 将 Cloudflare 托管的工作者网关与 LAN 上的 Relay 侧车配对。工作者提供认证的边缘 MCP 端点、持久对象代理、多地点路由、令牌边界以及部署/管理 CLI。中继边车是本地 MCP HTTP 客户端和转发器：它通过 HTTP 发现已配置的本地 MCP 服务器，并维护向工作者的出站 WebSocket。远程请求跟随 MCP 客户端→ Worker 网关→出站 WebSocket → Relay 侧车→通过 HTTP 本地 MCP 服务器;API 服务器不在该路径中。只读工具支持基于注释的多地点扇化，而写入则需要明确的定位位置。部署带有 npm 安装 -g unifi-mcp-worker & unifi-mcp-worker 的 Worker，然后查看 Relay 边车 README 连接本地服务器。 unifi-api-server 是一个独立的 HTTP 服务，面向不懂 MCP 的消费者。

概述（AI 翻译）

利用代理和代理AI工作流程管理您的UniFi部署。

服务器

服务器	状态	工具	包
网络	稳定	210	`unifi-network-mcp`
保护	稳定	63	`unifi-protect-mcp`
访问	稳定	37	`unifi-access-mcp`

插件

从Claude Code、Codex或OpenClaw市场安装这些;快速入门会展示方法。

插件	你能得到什么
`unifi-network`	网络MCP服务器、其代理技能与引导设置
`unifi-protect`	Protect MCP服务器，其代理技能与引导设置
`unifi-access`	Access MCP服务器，其代理技能与引导设置
`unifi-intelligence`	跨产品调查，结合使用Network和Protect，所有声明均被引用。事件调查在本地运行;安全巡逻和访客审计需要云工作者。它需要Network和Protect插件

特工技能表列出了每个插件发布的所有技能。

选择整合

你正在建造的东西	使用	为什么

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

UniFi MCP

Leverage agents and agentic AI workflows to manage your UniFi deployment.

Servers

Server	Status	Tools	Package
Network	Stable	210	`unifi-network-mcp`
Protect	Stable	63	`unifi-protect-mcp`
Access	Stable	37	`unifi-access-mcp`

Plugins

Install these from the Claude Code, Codex or OpenClaw marketplace; Quick Start shows how.

Plugin	What you get
`unifi-network`	The Network MCP server, its agent skills and guided setup
`unifi-protect`	The Protect MCP server, its agent skills and guided setup
`unifi-access`	The Access MCP server, its agent skills and guided setup
`unifi-intelligence`	Cross-product investigations that use Network and Protect together, with every claim cited. Incident Investigation runs locally; Security Patrol and Visitor Audit need the cloud worker. It requires the Network and Protect plugins

The Agent Skills table lists every skill each plugin ships.

Choose an integration

What you are building	Use	Why
An AI assistant or another existing MCP client	Network, Protect, or Access MCP server	Standard MCP discovery, tool calls, permissions, and confirmation flows
A custom application, automation service, code-execution runtime, or MCP adapter	`unifi-api-server`	Your code controls call sequencing, data joins, resource limits, and approval flow
Remote access for an MCP client	Cloud Relay	Authenticated remote MCP routing without exposing the local servers directly

在 GitHub 查看完整 README

安装

uvx unifi-network-mcp@latest

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "unifi-network": {
      "command": "uvx",
      "args": ["unifi-network-mcp@latest"],
      "env": {
        // Server-specific vars take priority; UNIFI_* is the fallback
        "UNIFI_NETWORK_HOST": "192.168.1.1",
        "UNIFI_NETWORK_USERNAME": "admin",
        "UNIFI_NETWORK_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"
      }
    }
  }
}