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: UnifiyMe

필수 조건

• Python 3.8 이상

• uv 패키지 관리자

• UniFi 네트워크 애플리케이션

• UniFi API 키(UniFi 콘솔에서 얻음)

설정

1. API 키 생성:

   • https://unifi.ui.com 에서 UniFi 콘솔로 이동하세요.

   • 설정 » 제어 평면 » 통합으로 이동하세요.

   • "API 키 생성"을 클릭하세요

2. 저장소를 복제하고 설정합니다.

지엑스피1

3. 종속성 설치:

uv sync

4. 환경 변수 구성:

export UNIFI_API_KEY="your_api_key_here"

서버 실행

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

uv run mcp dev main.py

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

AI 에이전트 통합

Goose AI 설정

1. Goose를 열고 설정 » 확장 프로그램 » 사용자 지정 확장 프로그램 추가로 이동하세요.

2. 확장 프로그램을 구성하세요.

   • 아이디: 유니파이

   • 이름: 유니파이

   • 설명: UniFi 네트워크에 대한 정보를 얻으세요

   • 명령어: /Users/username/.local/bin/uv --directory /path/to/mcp-server-unifi run main.py

   • 환경 변수: UNIFI_API_KEY를 API 키로 설정하세요.

클로드 데스크탑 설정

1. Claude를 열고 설정 » 개발자 » 구성 편집으로 이동하세요.

2. claude_desktop_config.json 에 다음을 추가하세요:

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