Sonos MCP Server

Sonos MCP 서버

이 프로젝트는 네트워크에서 Sonos 기기를 제어하고 상호 작용할 수 있는 Sonos MCP(Model Context Protocol) 서버입니다. 기기 검색, 재생 제어, 기기 상태 조회, 대기열 관리 등 다양한 기능을 제공합니다.

특징

• 네트워크에서 Sonos 장치 검색
• 장치의 재생 상태를 검색하고 제어합니다.
• 재생 대기열 관리
• MCP 도구로 기능 노출

요구 사항

• 파이썬 3.7 이상
• Python 프로젝트 관리를 위한 uv

설치

1. 저장소를 복제합니다.지엑스피1
2. uv 사용하여 필요한 종속성을 설치합니다.
   uv sync

용법

서버 실행

스튜디오

stdio를 사용하여 서버를 실행합니다.

Supergateway를 사용한 SSE

supergateway 도구를 사용하여 SSE로 서버를 실행합니다.

또는 저장소에 제공된 편의 스크립트를 사용할 수 있습니다.

개발

MCP Inspector를 사용하여 "개발" 모드로 서버를 실행하려면:

이 명령은 테스트 및 디버깅 목적으로 MCP 검사기를 호스팅합니다.

개발 모드에서 SSE로 서버를 실행하려면 supergateway에 SSE 명령을 사용하고 두 번째 터미널 창에서 다음을 실행합니다.

사용 가능한 MCP 도구

제공된 MCP 도구를 사용하여 Sonos 기기와 상호 작용하세요. 사용 가능한 도구는 다음과 같습니다.

• get_all_device_states : 검색된 모든 Sonos 기기의 상태 정보를 검색합니다.
• now_playing : 모든 Sonos 기기에서 현재 재생 중인 트랙에 대한 정보를 검색합니다.
• get_device_state : 특정 Sonos 기기의 상태 정보를 검색합니다.
• pause , stop , play : Sonos 기기에서 재생을 제어합니다.
• next , previous : Sonos 기기에서 트랙을 건너뜁니다.
• get_queue , get_queue_length : Sonos 기기의 재생 대기열을 관리합니다.
• mode : Sonos 기기의 재생 모드를 가져오거나 설정합니다.
• partymode : 현재 Sonos 기기에서 파티 모드를 활성화합니다.
• speaker_info : Sonos 기기의 스피커 정보를 검색합니다.
• get_current_track_info : Sonos 기기의 현재 트랙 정보를 검색합니다.
• volume : Sonos 장치의 볼륨을 가져오거나 설정합니다.
• skip , play_index , remove_index_from_queue : Sonos 기기의 대기열에 있는 트랙을 관리합니다.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.