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 Spotify Artist Radio

• Search across local library + Spotify (via the Spotty plugin)

• 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          # 110 tests
python -m mypy client.py main.py
python -m pyflakes client.py main.py tests/

Requirements

• Python 3.12+

• A running Lyrion Music Server (9.x)

• Spotty plugin (optional, for Spotify)