lyrion-mcp

MCP-Server für Lyrion Music Server / Logitech Media Server.

Er ermöglicht einem KI-Agenten, LMS-Player über die LMS-JSON-RPC-API zu inspizieren und zu steuern: Player, Wiedergabe, Lautstärke, Wiedergabelisten, Favoriten, Radio, Bibliothekssuche und Bibliotheksdurchsuchung.

Funktionen

Server und Player

• LMS-Konnektivität testen

• Serverstatus, Version, Bibliotheksstatistiken und Scan-Fortschritt lesen

• Player auflisten

• Player anhand von LMS-ID, exaktem Namen oder eindeutigem Namensfragment auflösen

• Detaillierten Playerstatus und aktuelle Wiedergabeliste lesen

Wiedergabesteuerung

• Wiedergabe, Pause, Wiedergabe/Pause umschalten, Stopp

• Zurück / Weiter

• Lautstärke einstellen

• Ein/Aus/Umschalten

• Zu Position springen

• Einschlaf-Timer

• Zufallswiedergabe- und Wiederholungsmodi

• Player synchronisieren / desynchronisieren

Wiedergabeliste und Wiedergabequellen

• Aktuelle Wiedergabeliste anzeigen

• Aktuelle Wiedergabeliste leeren

• Bibliothekstitel anhand der Titel-ID laden/abspielen oder anhängen

• Direkte URL/Stream abspielen

• Gespeicherte LMS-Wiedergabelisten auflisten

• Gespeicherte Wiedergabeliste anhand der Wiedergabelisten-ID abspielen

• Favoriten auflisten

• Radioanbieter/Kategorien der obersten Ebene auflisten

Bibliothek durchsuchen/suchen

• Titel, Alben und Künstler suchen

• Genres, Alben, Jahre auflisten

• Musikordner durchsuchen

• Titel eines Albums auflisten

• Alben oder Titel eines Künstlers auflisten

• LMS-Bibliotheksscan auslösen

Diagnose

• Schreibgeschützter JSON-RPC-Helfer für sichere Fehlerbehebungsbefehle.

Related MCP server: Plex MCP Server

Werkzeuge

• 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

Konfiguration

Umgebungsvariablen:

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

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

Beispiel-Client-Konfiguration

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

Hinweise

• Dieser Server erfordert standardmäßig keine LMS-Anmeldeinformationen, da Standard-LMS-JSON-RPC-Bereitstellungen normalerweise LAN-lokal sind. Platzieren Sie ihn hinter Ihren üblichen Netzwerkkontrollen.

• Das Bereitstellen von Wiedergabesteuerungen für einen KI-Agenten kann ändern, was auf Ihren Lautsprechern abgespielt wird. Überprüfen Sie die Agentenberechtigungen entsprechend.

Lizenz

MIT