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

Quick Start

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

Configuration

Set environment variables (see .env.example):

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

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

  • Spotty plugin (Spotify)

  • lms-deezer (Deezer)

  • TIDAL plugin (TIDAL)