local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
Provides tools for controlling Sonos audio devices, including discovering devices on a network, controlling playback (play, pause, stop, next, previous), managing playback queues, adjusting volume, retrieving now playing information, and enabling party mode across speakers.
Sonos MCP 서버
이 프로젝트는 네트워크에서 Sonos 기기를 제어하고 상호 작용할 수 있는 Sonos MCP(Model Context Protocol) 서버입니다. 기기 검색, 재생 제어, 기기 상태 조회, 대기열 관리 등 다양한 기능을 제공합니다.
특징
- 네트워크에서 Sonos 장치 검색
- 장치의 재생 상태를 검색하고 제어합니다.
- 재생 대기열 관리
- MCP 도구로 기능 노출
요구 사항
- 파이썬 3.7 이상
- Python 프로젝트 관리를 위한
uv
설치
- 저장소를 복제합니다.지엑스피1
uv사용하여 필요한 종속성을 설치합니다.Copy
용법
서버 실행
스튜디오
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 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.
You must be authenticated.
모델 컨텍스트 프로토콜을 통해 네트워크상의 Sonos 기기를 제어하고 상호 작용할 수 있는 서버로, 기기 검색, 재생 제어, 기기 상태 검색, 대기열 관리 기능을 제공합니다.