lyrion-mcp

Servidor MCP para Lyrion Music Server / Logitech Media Server.

Permite a un agente de IA inspeccionar y controlar los reproductores LMS a través de la API JSON-RPC de LMS: reproductores, reproducción, volumen, listas de reproducción, favoritos, radio, búsqueda en la biblioteca y navegación por la biblioteca.

Características

Servidor y reproductores

• Probar la conectividad con LMS

• Leer el estado del servidor, la versión, las estadísticas de la biblioteca y el progreso del escaneo

• Listar reproductores

• Resolver reproductores por id de LMS, nombre exacto o fragmento único de nombre

• Leer el estado detallado del reproductor y la lista de reproducción actual

Controles de reproducción

• Reproducir, pausar, alternar reproducción/pausa, detener

• Anterior / siguiente

• Establecer volumen

• Encender/apagar/alternar

• Buscar posición

• Temporizador de suspensión

• Modos de reproducción aleatoria y repetición

• Sincronizar / desincronizar reproductores

Listas de reproducción y fuentes de reproducción

• Mostrar la lista de reproducción actual

• Limpiar la lista de reproducción actual

• Cargar/reproducir o añadir una pista de la biblioteca por id de pista

• Reproducir una URL/flujo directo

• Listar listas de reproducción guardadas de LMS

• Reproducir una lista de reproducción guardada por id de lista

• Listar favoritos

• Listar proveedores/categorías de radio de nivel superior

Navegación/búsqueda en la biblioteca

• Buscar pistas, álbumes y artistas

• Listar géneros, álbumes, años

• Navegar por carpetas de música

• Listar las pistas de un álbum

• Listar los álbumes o pistas de un artista

• Activar el rescan de la biblioteca de LMS

Diagnósticos

• Ayudante JSON-RPC sin procesar de solo lectura para comandos de solución de problemas seguros.

Related MCP server: Plex MCP Server

Herramientas

• 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

Configuración

Variables de entorno:

Docker

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

Endpoint 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

Ejemplo de configuración de cliente

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

Notas

• Este servidor no requiere credenciales de LMS por defecto porque las implementaciones estándar de JSON-RPC de LMS suelen ser locales a la LAN. Colócalo detrás de tus controles de red habituales.

• Exponer los controles de reproducción a un agente de IA puede cambiar lo que se está reproduciendo en tus altavoces. Revisa los permisos del agente en consecuencia.

Licencia

MIT