Skip to main content
Glama
edk4971

Lyrion MCP Server

by edk4971
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python

Lyrion MCP Server

An MCP server that lets LLMs control a Lyrion Music Server (LMS / Squeezebox) instance.

Features

  • 9 MCP tools (optimized for context efficiency — ~1,400 tokens of definition overhead)

  • Play by URL, track ID, search, collection ID, or Artist Radio

  • Search across local library + streaming plugins (Spotify/Spotty, Deezer, TIDAL)

  • Pluggable streaming-service adapters, configured via LYRION_PLUGINS

  • Full playback control: pause, stop, seek, power on/off

  • Playlist management: add, insert, delete, clear, move, jump, save

  • Player settings: volume, shuffle, repeat, mute

  • Player sync/unsync

  • Library browsing: genres, artists, albums, titles, years, playlists

  • Raw LMS CLI passthrough for advanced commands

Related MCP server: Music MCP Server

Quick Start

pip install -r requirements.txt
LMS_HOST=your-lms-host python main.py

Configuration

Set environment variables (see .env.example):

Variable

Default

Description

LMS_HOST

localhost

Lyrion server host

LMS_PORT

9000

Lyrion server port

LMS_USERNAME

(none)

LMS username (if auth enabled)

LMS_PASSWORD

(none)

LMS password (if auth enabled)

LMS_HTTPS

off

Set 1 if LMS uses HTTPS

LYRION_PLUGINS

(all)

Comma-separated streaming plugins to enable (spotify, deezer, tidal)

MCP_TRANSPORT

stdio

stdio, sse, or streamable-http

MCP_HOST

0.0.0.0

Bind address (HTTP transports)

MCP_PORT

8000

Port (HTTP transports)

Docker

docker build -t lyrion-mcp .
docker run -d -p 8000:8000 -e LMS_HOST=your-lms-host lyrion-mcp

The server runs on http://localhost:8000 using the streamable-http transport. Point your MCP client at that URL.

Tools

Tool

Description

get_status

System topology (all players) or now-playing (with player_id)

play_media

Play by URL, track_id, search (defaults to Artist Radio), or collection ID

search_media

Search local library + Spotify, return playable URLs

control_playback

Pause, stop, play, seek, power on/off

manage_playlist

Add, insert, delete, clear, move, jump, save

set_player

Volume, shuffle, repeat, mute

sync_players

Sync or unsync players

browse_library

Browse genres/artists/albums/titles/years/playlists

query_lms

Raw LMS CLI passthrough

Development

pip install -r requirements.txt
python -m pytest -q          # unit tests
python -m mypy client.py main.py plugins.py
python -m pyflakes client.py main.py plugins.py tests/

Requirements

  • Python 3.12+

  • A running Lyrion Music Server (9.x)

  • One or more streaming plugins (all optional):

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • MCP Spotify Server

    fborello
    A
    license
    A
    quality
    D
    maintenance
    Enables interaction with Spotify through LLMs using OAuth2 authentication. Supports music search, playback control, playlist management, and device management through natural language commands.
    14
    2
    MIT

  • lms-mcp

    shermozle
    A
    license
    B
    quality
    C
    maintenance
    MCP server that provides LLM tools to interact with Lyrion Music Server (LMS), enabling player control, playback management, playlist operations, and music library search.
    55
    24 npm
    MIT

  • lyrion-mcp

    SimoneB79
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables an AI agent to inspect and control Lyrion Music Server (Logitech Media Server) players via the LMS JSON-RPC API, including playback, volume, playlists, favorites, radio, and library search/browse.
    MIT