UniFi MCP

이것은 무엇인가: Model Context Protocol (MCP) 서버 모음으로, AI 어시스턴트(Claude, Codex, 사용자 정의 에이전트 등)가 Ubiquiti UniFi 컨트롤러와 상호 작용할 수 있게 합니다. Network, Protect(카메라), Access(문/방문자) 기능을 에이전트가 호출 가능한 도구로 노출합니다.

주요 구성 요소:

• Network MCP (210개 도구), Protect MCP (63개 도구), Access MCP (37개 도구) – 각각 UniFi 앱을 대상으로 합니다.
• API 서버 – 사용자 정의 앱과 자동화를 위한 독립적인 HTTP 서비스(REST + GraphQL + SSE). 범위가 지정된 API 키를 제공합니다.
• Cloud Relay – 원격 액세스를 위한 베타 솔루션: Cloudflare 호스팅 Worker 게이트웨이가 로컬 릴레이 사이드카와 페어링되어 WebSocket을 통해 MCP 호출을 라우팅합니다. 로컬 서버의 직접 노출을 피합니다.
• 에이전트 플러그인 – Claude Code, Codex, OpenClaw용 공식 패키지로, MCP 서버를 설정 스킬과 안전 가드레일과 함께 번들로 제공합니다.

작동 방식:

• 서버는 로컬 관리자 계정(SSO 아님)을 사용하여 UniFi 컨트롤러에 연결합니다.
• 에이전트는 표준 MCP 디스커버리를 통해 unifi_list_clients, unifi_create_firewall_rule, unifi_get_motion_events 같은 도구를 호출합니다.
• 변경 작업은 미리보기 후 확인 흐름을 사용합니다. 설정은 자격 증명을 개인 파일에 저장하고 비밀 유출을 방지합니다.
• 지연 로딩 모드는 도메인 도구를 온디맨드로 등록하는 메타 도구를 노출하여 컨텍스트를 작게 유지합니다.
• 응답 크기는 MCP 프로토콜 버전에 따라 적응하여 호환성을 보장합니다.

빠른 시작:

• Claude Code의 경우: /plugin marketplace add sirkirby/unifi-mcp를 실행한 후 플러그인을 설치합니다.
• 다른 클라이언트의 경우: uvx unifi-network-mcp@latest 등을 실행하고 환경 변수를 설정합니다.

사용 사례:

• "Guest VLAN의 모든 클라이언트 신호 강도를 표시해."
• "지난 1시간 동안 움직임을 감지한 카메라를 나열해."
• "John Smith에게 내일 9–5 방문자 패스를 만들어."
• 교차 제품 인텔리전스: Network + Protect 컨텍스트로 사건을 조사합니다.

이 프로젝트는 활발히 개발 중이며(플러그인은 서버 0.37.x에 고정), 보안 모델을 갖추고 MIT 라이선스로 배포됩니다. AI 기반 인프라 관리를 위한 진정하고 실질적인 도구입니다.