lyrion-mcp

Lyrion Music Server / Logitech Media Server용 MCP 서버입니다.

AI 에이전트가 LMS JSON-RPC API를 통해 LMS 플레이어를 검사하고 제어할 수 있게 해줍니다: 플레이어, 재생, 볼륨, 재생 목록, 즐겨찾기, 라디오, 라이브러리 검색 및 라이브러리 탐색.

기능

서버 및 플레이어

• LMS 연결 테스트

• 서버 상태, 버전, 라이브러리 통계 및 검색 진행 상황 읽기

• 플레이어 나열

• LMS ID, 정확한 이름 또는 고유 이름 조각으로 플레이어 식별

• 상세 플레이어 상태 및 현재 재생 목록 읽기

재생 제어

• 재생, 일시정지, 재생/일시정지 전환, 정지

• 이전 / 다음

• 볼륨 설정

• 전원 켜기/끄기/전환

• 위치 탐색

• 슬립 타이머

• 셔플 및 반복 모드

• 플레이어 동기화 / 동기화 해제

재생 목록 및 재생 소스

• 현재 재생 목록 표시

• 현재 재생 목록 지우기

• 트랙 ID로 라이브러리 트랙 로드/재생 또는 추가

• 직접 URL/스트림 재생

• 저장된 LMS 재생 목록 나열

• 재생 목록 ID로 저장된 재생 목록 재생

• 즐겨찾기 나열

• 최상위 라디오 제공자/카테고리 나열

라이브러리 탐색/검색

• 트랙, 앨범 및 아티스트 검색

• 장르, 앨범, 연도 나열

• 음악 폴더 탐색

• 앨범의 트랙 나열

• 아티스트의 앨범 또는 트랙 나열

• LMS 라이브러리 재검색 실행

진단

• 안전한 문제 해결 명령을 위한 읽기 전용 원시 JSON-RPC 헬퍼.

Related MCP server: Plex MCP Server

도구

• lms_test_connection

• lms_server_status

• lms_players

• lms_player_status

• lms_play, lms_pause, lms_play_pause, lms_stop

• lms_next, lms_previous

• lms_set_volume, lms_set_power

• lms_seek, lms_sleep

• lms_set_shuffle, lms_set_repeat

• lms_sync, lms_unsync

• lms_playlist, lms_clear_playlist

• lms_play_track, lms_add_track, lms_play_url

• lms_saved_playlists, lms_play_playlist

• lms_favorites, lms_radios

• lms_search_tracks, lms_search_albums, lms_search_artists

• lms_genres, lms_albums, lms_years

• lms_music_folder, lms_album_tracks, lms_artist_albums, lms_artist_tracks

• lms_rescan_library

• lms_raw_readonly

구성

환경 변수:

Docker

docker build -t lyrion-mcp .
docker run --rm -p 8310:8310 \
  -e LMS_URL=http://host.docker.internal:9000/jsonrpc.js \
  lyrion-mcp

MCP 엔드포인트:

http://localhost:8310/sse

Docker Compose

services:
  lyrion-mcp:
    image: ghcr.io/simoneb79/lyrion-mcp:latest
    environment:
      LMS_URL: http://host.docker.internal:9000/jsonrpc.js
    ports:
      - "8310:8310"
    restart: unless-stopped

예제 클라이언트 구성

{
  "mcpServers": {
    "lyrion-mcp": {
      "url": "http://localhost:8310/sse"
    }
  }
}

참고

• 이 서버는 기본적으로 LMS 자격 증명을 요구하지 않습니다. 표준 LMS JSON-RPC 배포는 일반적으로 LAN 내부에 한정되기 때문입니다. 일반적인 네트워크 제어 수단 뒤에 두십시오.

• AI 에이전트에 재생 제어를 노출하면 스피커에서 재생 중인 내용이 변경될 수 있습니다. 이에 따라 에이전트 권한을 검토하십시오.

라이선스

MIT