lms-mcp

An MCP server for controlling a Lyrion Music Server (formerly Logitech Media Server / SlimServer / Squeezebox server).

It talks to LMS over its JSON-RPC (CLI-over-HTTP) API on port 9000, and exposes playback control, library search and queue management as MCP tools.

Requirements

• Node.js ≥ 20

• A reachable Lyrion Music Server with the web interface enabled

Setup

npm install
npm run build

Configure via environment variables (see .env.example):

The server supports two transports:

• stdio — for running locally, launched by the MCP client as a child process.

• Streamable HTTP — a long-running endpoint at /mcp, used for the always-on Docker deployment. This is the image's default.

Local use (stdio)

npm install && npm run build

{
  "mcpServers": {
    "lms": {
      "command": "node",
      "args": ["/absolute/path/to/lms-mcp/dist/index.js"],
      "env": { "LMS_URL": "http://192.168.1.10:9000" }
    }
  }
}

During development: npm run dev.

Server use (Docker, HTTP)

Multi-arch images (linux/amd64, linux/arm64) are published to the GitHub Container Registry on every push to main and every v* tag:

ghcr.io/eggs-gd/lms-mcp:latest

Run it with the bundled compose.yaml:

cp .env.example .env      # set LMS_URL and MCP_AUTH_TOKEN
docker compose up -d

Then point the MCP client at the URL:

{
  "mcpServers": {
    "lms": {
      "url": "http://your-server:3000/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

GET /health returns a plain JSON liveness check.

Tools

Reference

• LMS CLI API docs: http://<your-server>:9000/html/docs/cli-api.html

License

MIT