lyrion-mcp

MCP-сервер для Lyrion Music Server / Logitech Media Server.

Он позволяет ИИ-агенту просматривать и управлять плеерами LMS через JSON-RPC API LMS: плееры, воспроизведение, громкость, плейлисты, избранное, радио, поиск по библиотеке и навигация по библиотеке.

Возможности

Сервер и плееры

• Проверка подключения к LMS

• Чтение статуса сервера, версии, статистики библиотеки и хода сканирования

• Список плееров

• Поиск плееров по id LMS, точному имени или уникальному фрагменту имени

• Чтение подробного статуса плеера и текущего плейлиста

Управление воспроизведением

• Воспроизведение, пауза, переключение воспроизведение/пауза, остановка

• Следующий / предыдущий трек

• Установка громкости

• Включение/выключение питания/переключение

• Переход к позиции

• Таймер сна

• Режимы перемешивания и повтора

• Синхронизация / отмена синхронизации плееров

Плейлист и источники воспроизведения

• Показать текущий плейлист

• Очистить текущий плейлист

• Загрузить/воспроизвести или добавить трек из библиотеки по id трека

• Воспроизвести прямой URL/поток

• Список сохранённых плейлистов LMS

• Воспроизвести сохранённый плейлист по id плейлиста

• Список избранного

• Список радио-провайдеров/категорий верхнего уровня

Просмотр/поиск по библиотеке

• Поиск треков, альбомов и исполнителей

• Список жанров, альбомов, годов

• Просмотр музыкальных папок

• Список треков альбома

• Список альбомов или треков исполнителя

• Запуск повторного сканирования библиотеки LMS

Диагностика

• Вспомогательный инструмент raw 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 endpoint:

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, поскольку стандартные развёртывания JSON-RPC LMS обычно находятся в локальной сети. Поместите его за обычные средства контроля сети.

• Предоставление управления воспроизведением ИИ-агенту может изменить то, что играет на ваших колонках. Соответственно проверьте разрешения агента.

Лицензия

MIT