MCP 서버 UniFi

MCP(Management Control Protocol)를 통해 UniFi 네트워크 장치를 관리하고 제어하는 서버 구현입니다. 이 서버는 UniFi Network API를 래핑하여 Goose 및 Claude와 같은 AI 에이전트를 통해 UniFi 네트워크와의 자연어 상호작용을 지원합니다.

특징

AI 에이전트를 통해 자연어를 사용하여 UniFi 사이트 및 장치 쿼리
UniFi Network 애플리케이션에 연결되는 로컬 서버 구현
Goose AI와 Claude Desktop 모두와 호환 가능
보안 API 키 기반 인증

Related MCP server: MCP Server

필수 조건

Python 3.8 이상
uv 패키지 관리자
UniFi 네트워크 애플리케이션
UniFi API 키(UniFi 콘솔에서 얻음)

설정

API 키 생성:
- https://unifi.ui.com 에서 UniFi 콘솔로 이동하세요.
- 설정 » 제어 평면 » 통합으로 이동하세요.
- "API 키 생성"을 클릭하세요
저장소를 복제하고 설정합니다.

지엑스피1

종속성 설치:

uv sync

환경 변수 구성:

export UNIFI_API_KEY="your_api_key_here"

서버 실행

MCP 개발 서버를 시작합니다.

uv run mcp dev main.py

MCP 검사기는 테스트 및 디버깅을 위해 http://localhost:5173 에서 사용할 수 있습니다.

AI 에이전트 통합

Goose AI 설정

Goose를 열고 설정 » 확장 프로그램 » 사용자 지정 확장 프로그램 추가로 이동하세요.
확장 프로그램을 구성하세요.
- 아이디: 유니파이
- 이름: 유니파이
- 설명: UniFi 네트워크에 대한 정보를 얻으세요
- 명령어: /Users/username/.local/bin/uv --directory /path/to/mcp-server-unifi run main.py
- 환경 변수: UNIFI_API_KEY를 API 키로 설정하세요.

클로드 데스크탑 설정

Claude를 열고 설정 » 개발자 » 구성 편집으로 이동하세요.
claude_desktop_config.json 에 다음을 추가하세요:

{ "mcpServers": { "unifi": { "command": "/Users/username/.local/bin/uv", "args": [ "--directory", "/path/to/mcp-server-unifi", "run", "main.py" ] } } }