Lyrion MCP Server

A Model Context Protocol (MCP) server for controlling Lyrion Music Server (formerly Logitech Media Server/Squeezebox Server) via its JSON-RPC HTTP interface.

Architecture

This server implements a dual-layer JSON-RPC architecture:

1. MCP Protocol Layer: Communicates over stdin/stdout using JSON-RPC 2.0

   • Stdout is reserved exclusively for MCP responses
   • Logs are sent to stderr for debugging

2. Lyrion Client Layer: Communicates with Lyrion Music Server via HTTP

   • JSON-RPC 2.0 over HTTP to http://LYRION_HOST:LYRION_HTTP_PORT/jsonrpc.js
   • Default: localhost:9000

Features

• JSON-RPC 2.0 over HTTP (MCP protocol compliant)
• Player control (play, pause, stop, power)
• Volume control with mute support
• Track navigation and seeking
• Playlist and library browsing
• Multi-room sync groups
• Sleep timer
• Favorites management
• Display control (brightness, messages)
• Library statistics and scanning
• Player preferences

Installation

Pre-built Binaries

Download pre-built binaries from GitHub Actions:

1. Click the latest workflow run
2. Scroll to Artifacts at the bottom
3. Download the appropriate binary for your platform:

| Platform | Artifact | |----------|----------| | Linux (x86_64) | lyrion-mcp-server-x86_64-unknown-linux-gnu | | Windows (x86_64) | lyrion-mcp-server-x86_64-pc-windows-msvc | | macOS (Intel) | lyrion-mcp-server-x86_64-apple-darwin | | macOS (Apple Silicon) | lyrion-mcp-server-aarch64-apple-darwin |

From Source

# Clone the repository
git clone https://github.com/yourusername/lyrion-mcp-server.git
cd lyrion-mcp-server

# Build the release binary
cargo build --release

# The binary will be at target/release/lyrion-mcp-server

Configuration

The server connects to Lyrion Music Server via HTTP JSON-RPC. Configure via environment variables:

# Optional: Override defaults
export LYRION_HOST=localhost     # Default: localhost
export LYRION_HTTP_PORT=9000     # Default: 9000

MCP Configuration

Add to your Claude MCP config (~/.claude/mcp_config.json or desktop app settings):

{
  "mcpServers": {
    "lyrion": {
      "command": "/path/to/lyrion-mcp-server/target/release/lyrion-mcp-server"
    }
  }
}

Available Tools

Server Information (3 tools)

• get_server_version - Get Lyrion version
• get_player_count - Get number of players
• list_players - List all players

Player Control (40+ tools)

• Playback: play, pause, stop, power_on, power_off
• Volume: get_volume, set_volume, volume_up, volume_down, mute_toggle
• Navigation: next_track, prev_track, jump_to_index, seek
• Status: get_player_status, get_current_track
• Playlists: get_playlists, load_playlist, add_playlist, create_playlist, delete_playlist, clear_queue, shuffle_queue, get_playlist_tracks
• Playlist Editing: add_track_to_playlist, add_album_to_playlist
• Queue: add_track_to_queue, add_album_to_queue
• Library: search_tracks, get_genres, get_artists, get_albums, get_album_info, play_song, get_songs_by_artist, get_songs_on_album
• Modes: set_repeat, get_repeat, set_shuffle, get_shuffle

Advanced Features (26 tools)

• Sync Groups: get_sync_groups, get_sync_group, sync_players, unsync_player, unsync_all
• Sleep Timer: get_sleep_timer, set_sleep_timer, cancel_sleep_timer
• Favorites: get_favorites, play_favorite
• Display: show_message, clear_display, set_brightness, get_brightness
• Library Stats: get_library_st

... View full README on GitHub