enuno/unifi-mcp-server

해결하는 문제

UniFi 네트워크 인프라를 관리하려면 복잡한 웹 인터페이스를 수동으로 탐색해야 하는 경우가 많습니다. 이 프로젝트는 AI 에이전트가 UniFi 하드웨어와 상호 작용할 수 있는 표준화된 방법을 제공하여 모델 컨텍스트 프로토콜(MCP)을 통해 네트워크 데이터를 읽고, 구성을 조정하고, 장치를 자동으로 관리할 수 있게 합니다.

작동 방식

이 서버는 AI 클라이언트(예: Claude Desktop 또는 Cursor)와 UniFi 컨트롤러 사이의 브리지 역할을 합니다. 네트워크 설정, 방화벽 규칙, 카메라 관리, 장치 진단 등 수백 가지 특정 도구를 표준화된 명령으로 노출합니다. '로컬' 모드로 실행하여 자체 하드웨어를 제어하거나 UniFi 클라우드 API에 연결하여 집계 사이트 관리를 수행할 수 있습니다. 변경 사항에 대한 필수 확인, 드라이런 모드, 역할 기반 액세스 제어와 같은 안전 기능이 포함되어 있습니다.

대상 사용자

이 도구는 AI를 사용하여 UniFi 인프라를 자동화하려는 네트워크 관리자, 홈 랩 애호가 및 개발자를 위해 설계되었습니다. 방화벽 규칙 감사, WiFi 채널 계획, 자연어 프롬프트를 통한 다중 사이트 배포 관리와 같은 복잡한 작업을 수행하려는 사용자에게 특히 유용합니다.

주요 기능

• UniFi Network, Protect 및 클라우드 서비스를 포괄적으로 제어하는 300개 이상의 도구를 제공합니다.
• 중앙 집중식 로깅 및 캐싱을 통해 단일 인터페이스에서 여러 컨트롤러를 관리할 수 있는 'Fleet 모드'를 지원합니다.
• 감사 로그, 드라이런 기능, 위험 계층 기반 액세스 제어를 포함한 내장 안전 메커니즘.
• AI 에이전트가 네트워크 작업을 효과적으로 이해하고 실행하도록 돕는 전용 '에이전트 스킬'(Markdown 파일)을 제공합니다.
• Prometheus 메트릭, SIEM 내보내기 및 웹훅 통합을 지원하는 높은 관찰 가능성.