MCP 서버 UniFi
MCP(Management Control Protocol)를 통해 UniFi 네트워크 장치를 관리하고 제어하는 서버 구현입니다. 이 서버는 UniFi Network API를 래핑하여 Goose 및 Claude와 같은 AI 에이전트를 통해 UniFi 네트워크와의 자연어 상호작용을 지원합니다.
특징
- AI 에이전트를 통해 자연어를 사용하여 UniFi 사이트 및 장치 쿼리
- UniFi Network 애플리케이션에 연결되는 로컬 서버 구현
- Goose AI와 Claude Desktop 모두와 호환 가능
- 보안 API 키 기반 인증
필수 조건
- Python 3.8 이상
uv 패키지 관리자- UniFi 네트워크 애플리케이션
- UniFi API 키(UniFi 콘솔에서 얻음)
설정
- API 키 생성:
- 저장소를 복제하고 설정합니다.
지엑스피1
- 종속성 설치:
- 환경 변수 구성:
export UNIFI_API_KEY="your_api_key_here"
서버 실행
MCP 개발 서버를 시작합니다.
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"
]
}
}
}