sirkirby/unifi-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

975 stars 133 forks 품질 86 트렌드 49MIT

Repository Install

UniFi 애플리케이션 제품군인 Network, Protect, Access, Drive용 MCP 서버

개요

에이전트와 에이전트 AI 워크플로우를 활용해 UniFi 배포를 관리하세요. Cloud Relay는 Cloudflare 호스팅 Worker 게이트웨이와 LAN의 Relay 사이드카를 페어링합니다. Worker는 인증된 엣지 MCP 엔드포인트, 내구성 있는 객체 브로커, 다중 위치 라우팅, 토큰 경계, 배포/관리 CLI를 제공합니다. Relay 사이드카는 로컬 MCP HTTP 클라이언트이자 포워더로, HTTP를 통해 설정된 로컬 MCP 서버를 발견하고 워커에게 아웃바운드 WebSocket을 유지합니다. 원격 요청은 MCP 클라이언트→ 워커 게이트웨이를 따라→ 아웃바운드 WebSocket → Relay 사이드카 → HTTP를 통한 로컬 MCP 서버로 이루어집니다; API 서버는 이 경로에 포함되지 않습니다. 읽기 전용 도구는 주석 기반 다중 위치 팬아웃을 지원하며, 쓰기는 명시적인 위치 타겟팅이 필요합니다. Worker를 npm install -g unifi-mcp-worker & unifi-mcp-worker install 설치로 배포한 후, Relay 사이드카 README를 확인하여 로컬 서버를 연결합니다. unifi-api-server는 MCP를 사용하지 않는 소비자를 위한 독립적인 HTTP 서비스입니다.

개요(AI 번역)

에이전트와 에이전트 AI 워크플로우를 활용해 UniFi 배포를 관리하세요.

서버

서버	상태	도구	패키지
네트워크	안정	210	`unifi-network-mcp`
보호하라	안정	63	`unifi-protect-mcp`
접근	안정	37	`unifi-access-mcp`

플러그인

Claude Code, Codex 또는 OpenClaw 마켓플레이스에서 설치하세요; Quick Start가 설치 방법을 보여줍니다.

플러그인	무엇을 얻었는지
`unifi-network`	네트워크 MCP 서버, 그 에이전트 기술 및 가이드 설정
`unifi-protect`	Protect MCP 서버, 그 에이전트 기술과 가이드 설정
`unifi-access`	Access MCP 서버, 그 에이전트 기술과 가이드 설정
`unifi-intelligence`	네트워크와 보호를 함께 사용하는 교차 제품 조사, 모든 주장이 인용됩니다. 사고 조사는 로컬에서 진행됩니다; 보안 순찰과 방문자 감사는 클라우드 작업자가 필요합니다. 네트워크와 보호(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

MCP 초보자라면? 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"
      }
    }
  }
}