sirkirby/unifi-mcp

해결하는 문제

UniFi MCP는 AI 어시스턴트 및 자동화 도구가 Ubiquiti UniFi 컨트롤러와 상호작용할 수 있도록 합니다. 자연어 인터페이스와 복잡한 네트워크 인프라 관리 사이의 격차를 메우며, AI 에이전트를 통해 UniFi Network, Protect, Access 배포를 질의, 감사, 수정할 수 있게 해줍니다.

작동 방식

이 프로젝트는 Model Context Protocol (MCP)를 구현하여 UniFi 컨트롤러 기능을 쿼리 가능하고 조합 가능한 도구 세트로 노출합니다. 네트워크, Protect, Access 전용 서버로 구성되며, 관리자 계정을 통해 로컬 컨트롤러에 연결됩니다.

원격 접근을 위해 "Cloud Relay" 시스템을 사용합니다: Cloudflare가 호스팅하는 Worker 게이트웨이가 인증된 엣지 엔드포인트 역할을 하며, WebSocket을 통해 로컬 Relay 사이드카와 통신하여 요청을 로컬 MCP 서버로 전달합니다. 또한 MCP 외부 소비자를 위한 독립적인 REST 및 GraphQL API 서버도 포함되어 있습니다.

대상 사용자

수동적인 대시보드 탐색 대신 AI 기반 에이전트(Claude Code, Codex, OpenClaw 등)를 통해 인프라를 관리하고자 하는 네트워크 관리자 및 홈랩 애호가를 위한 것입니다.

주요 특징

• 포괄적인 도구 세트: 네트워크(192), Protect(61), Access(36) 도메인에서 수백 가지의 도구 제공.
• 에이전트 기능: 네트워크 건강 상태 점검, 100점 만점 평가 기반 방화벽 감사, 보안 요약 등 복잡한 작업을 위한 미리 정의된 기능 포함.
• 안전 우선: 모든 변경 작업에 대해 "미리 보기 → 확인" 흐름을 구현하고, Wi-Fi 암호 및 VPN 키와 같은 민감한 필드를 에이전트 컨텍스트에서 자동으로 마스킹(숨김)합니다.
• 유연한 배포: 로컬 직접 실행, AI IDE용 플러그인 설치, 원격 관리를 위한 클라우드 리레이 아키텍처를 모두 지원합니다.