Skip to main content
Glama

Lyngdorf MCP Server

DISCLAIMER: This project is an independent, community-developed tool and is NOT affiliated with, endorsed by, or supported by Lyngdorf Audio. Use at your own risk. For official Lyngdorf products and support, visit lyngdorf.steinwaylyngdorf.com.

CODE GENERATION: Most of this codebase was generated using Claude Code, Anthropic's AI coding agent. The implementation demonstrates Claude Code's ability to create production-ready software from high-level requirements.

A Model Context Protocol (MCP) server for controlling Lyngdorf Audio devices (TDAI, MP, and CD series) via TCP. Features automatic device discovery, comprehensive control, volume safety, and built-in documentation.

Lyngdorf MCP in Action

Features

  • 🔍 Auto-Discovery: Automatically finds and connects to Lyngdorf devices on startup

  • 🛡️ Volume Safety: Two-tier safety system (Warning & Hard Limit) to protect your ears and equipment

  • 🧠 Smart Capabilities: Automatically detects device model and prevents unsupported commands (e.g., no streaming on TDAI-2170)

  • 🎵 43 Control Tools: Power, volume, source, RoomPerfect, voicing, tone controls, playback, and streaming

  • 📚 Knowledge Base: Built-in manual data and command references for multiple models

  • 🔄 Auto-Reconnect: Maintains connection with automatic recovery

  • 🌐 Multi-Device: Supports TDAI, MP, and CD series with seamless device switching

Related MCP server: lyrion-mcp

Supported Devices

The server includes specific capability profiles for:

  • TDAI Series: 1120, 2170, 2190, 2210, 3400

  • MP Series: 40, 50, 60

  • CD Series: CD-1

Unknown devices are supported with a generic profile assuming full capabilities.

Installation

Prerequisites

  • Node.js 22+

  • npm or yarn

Install from npm

npm install -g lyngdorf-mcp

Or use npx without installing:

npx lyngdorf-mcp

Install from Source

git clone <repository-url>
cd lyngdorf-mcp
npm install
cp .env.example .env
npm run build

Usage

With Claude Desktop

Add to your Claude Desktop configuration:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "lyngdorf": {
      "command": "npx",
      "args": ["lyngdorf-mcp"],
      "env": {
        "VOLUME_WARNING_THRESHOLD": "-20",
        "VOLUME_HARD_LIMIT": "-10"
      }
    }
  }
}

Using local installation:

{
  "mcpServers": {
    "lyngdorf": {
      "command": "node",
      "args": ["/absolute/path/to/lyngdorf-mcp/dist/index.js"],
      "env": {
        "VOLUME_WARNING_THRESHOLD": "-20",
        "VOLUME_HARD_LIMIT": "-10"
      }
    }
  }
}

Configuration (Environment Variables)

Variable

Default

Description

LYNGDORF_IP

(Auto)

Manually specify device IP if auto-discovery fails

VOLUME_WARNING_THRESHOLD

-15

Volume level (dB) that triggers a warning requiring user confirmation

VOLUME_HARD_LIMIT

-10

Maximum volume level (dB) that cannot be exceeded via tools

How It Works

On startup, the server:

  1. Auto-discovers all Lyngdorf devices on your network via mDNS

  2. Auto-connects if exactly one device is found

  3. Lists devices if multiple are found (use listDevices and selectDevice tools)

No manual configuration needed! Just start Claude Desktop and ask:

"What's my current volume?"

Available Tools (43)

Power Control

  • powerOn, powerOff, togglePower

  • checkPowerState - Check if device is active or in standby

Volume Control (Safety Protected)

  • setVolume - Set volume (with safety checks)

  • volumeUp, volumeDown - Adjust by 0.5dB

  • getVolume - Get current level

  • mute, unmute

Audio & Tone

  • setBass, getBass - Bass gain control

  • setTreble, getTreble - Treble gain control

  • setBalance, getBalance - L/R Balance

  • setBassFrequency, getBassFrequency

  • setTrebleFrequency, getTrebleFrequency

Input & Source

  • setSource, getSource

  • listSources - List all available inputs

RoomPerfect & Voicing

  • setRoomPerfectFocus, setRoomPerfectGlobal, getRoomPerfect

  • listRoomPerfectPositions - List available focus positions

  • setVoicing, nextVoicing, previousVoicing, getVoicing

  • listVoicings - List available voicing presets

Playback & Streaming (Model Dependent)

  • play, pause, stop, next, previous

  • getStreamType - Detect current stream (Spotify, Roon, AirPlay, etc.)

Device Management

  • discoverDevices, listDevices, selectDevice

  • getStatus - Comprehensive device status

Available Resources

Access manuals and documentation as MCP resources:

  • lyngdorf://manual/{model}/commands - Command reference

  • lyngdorf://manual/{model}/owners/index - Owner's Manual TOC

  • lyngdorf://manual/{model}/owners/{section} - Specific manual sections

  • lyngdorf://search?q={query} - Search all manuals

Supported Manuals: TDAI-1120, TDAI-2170, TDAI-2210, TDAI-3400

Troubleshooting

No Devices Found

  1. Ensure device is powered on and connected to the network.

  2. Check if you are on the same subnet.

  3. Try setting LYNGDORF_IP manually.

Volume Limit Errors

If you see "Volume -XdB exceeds warning threshold...", simply ask the user for confirmation to proceed, or lower the requested volume.

Development

Run in Development Mode

npm run dev

Test

npm test

Coverage: 125 passing tests covering tools, transport, discovery, and capabilities.

Project Structure

lyngdorf-mcp/
├── src/
│   ├── index.ts           # Server entry & discovery
│   ├── tools.ts           # Tool definitions & handlers
│   ├── capabilities.ts    # Device capability matrix
│   ├── transport.ts       # TCP communication
│   └── ...
├── docs/kb/               # JSON Knowledge Base
└── dist/                  # Compiled output

License

MIT

Disclaimer

This is an independent project developed by the community. It is NOT affiliated with, endorsed by, or supported by Lyngdorf Audio A/S or Steinway Lyngdorf.

Available Tools

43 tools
discoverDevicesC

Discover Lyngdorf devices on the network via mDNS

Inputs: timeout.

getAudioStatusB

Get current audio format information

Inputs: no named parameters.

getBalanceB

Get current left/right balance

Inputs: no named parameters.

getBassB

Get current bass gain level

Inputs: no named parameters.

getBassFrequencyC

Get current bass frequency

Inputs: no named parameters.

getDeviceInfoB

Get device model and identification information

Inputs: no named parameters.

getMuteStatusB

Check if audio is currently muted

Inputs: no named parameters.

getRoomPerfectB

Get current RoomPerfect setting

Inputs: no named parameters.

getSourceB

Get current audio input source

Inputs: no named parameters.

getStatusB

Get comprehensive device status

Inputs: no named parameters.

getStreamTypeB

Get the current streaming service (Spotify, AirPlay, Roon, etc.)

Inputs: no named parameters.

getTrebleB

Get current treble gain level

Inputs: no named parameters.

getTrebleFrequencyB

Get current treble frequency

Inputs: no named parameters.

getVoicingB

Get current voicing preset

Inputs: no named parameters.

getVolumeB

Get current music/audio volume level

Inputs: no named parameters.

listDevicesB

List all discovered Lyngdorf devices

Inputs: no named parameters.

listRoomPerfectPositionsB

List all RoomPerfect positions with their names from the device

Inputs: no named parameters.

listSourcesB

List all available input sources with their actual names from the device

Inputs: no named parameters.

listVoicingsB

List available voicing presets and show current selection

Inputs: no named parameters.

muteB

Mute the audio/music

Inputs: no named parameters.

nextA

Skip to next track. Works with streaming sources.

Inputs: no named parameters.

nextVoicingB

Switch to next voicing preset

Inputs: no named parameters.

pauseB

Pause music playback (same as play - it toggles). Works with streaming sources.

Inputs: no named parameters.

playA

Toggle music playback (play/pause). Works with streaming sources like Spotify, AirPlay, Roon, etc.

Inputs: no named parameters.

powerOffB

Turn the audio amplifier off

Inputs: no named parameters.

powerOnB

Turn the audio amplifier on

Inputs: no named parameters.

previousA

Go to previous track. Works with streaming sources.

Inputs: no named parameters.

previousVoicingB

Switch to previous voicing preset

Inputs: no named parameters.

selectDeviceC

Select and connect to a specific device by number

Inputs: device_number (required).

setBalanceC

Set left/right balance (L10-L1, 0, R1-R10)

Inputs: balance (required).

setBassB

Set bass gain level (-12 to +12 dB)

Inputs: gain (required).

setBassFrequencyC

Set bass frequency (20 to 800 Hz)

Inputs: frequency (required).

setRoomPerfectFocusC

Set RoomPerfect focus position (1-8)

Inputs: position (required).

setRoomPerfectGlobalB

Set RoomPerfect to Global position

Inputs: no named parameters.

setSourceC

Set input source

Inputs: source (required).

setTrebleC

Set treble gain level (-12 to +12 dB)

Inputs: gain (required).

setTrebleFrequencyB

Set treble frequency (1500 to 16000 Hz)

Inputs: frequency (required).

setVoicingC

Set voicing preset

Inputs: voicing (required).

setVolumeA

Set absolute volume level in dB. VOLUME GUIDANCE: dB scale is logarithmic - every 10dB increase doubles perceived loudness. Reference levels: -50 to -40dB (very quiet/background), -40 to -30dB (quiet conversation), -30 to -20dB (normal listening), -20 to -10dB (loud), -10 to 0dB (very loud), above 0dB (extremely loud, risk of speaker/hearing damage). Most music listening happens between -35 and -20 dB. Always be conservative when increasing volume.

Inputs: level (required).

togglePowerB

Toggle amplifier power state

Inputs: no named parameters.

unmuteB

Unmute the audio/music

Inputs: no named parameters.

volumeDownA

Decrease volume by 0.5dB steps. VOLUME GUIDANCE: Due to logarithmic nature of dB, single steps (0.5dB) are barely audible. For noticeable changes: use 4-6 steps (2-3dB) for moderate adjustments. Typical listening: -40 to -30dB (quiet background), -25 to -15dB (moderate), -10 to 0dB (loud). Always check current level first.

Inputs: steps.

volumeUpA

Increase volume by 0.5dB steps. VOLUME GUIDANCE: Due to logarithmic nature of dB, single steps (0.5dB) are barely audible. For noticeable changes: use 4-6 steps (2-3dB) for moderate adjustments, or 10+ steps for significant changes. Typical listening: -40 to -30dB (quiet background), -25 to -15dB (moderate), -10 to 0dB (loud). Always check current level first.

Inputs: steps.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 43 tools

    Disambiguation4/5

    Most tools have distinct purposes, but some pairs like 'play' and 'pause' (both toggle playback) or 'powerOn'/'powerOff'/'togglePower' could cause confusion due to overlapping functionality. The majority, however, target specific resources and actions clearly.

    Naming Consistency5/5

    Tool names follow a consistent verb_noun pattern throughout, with clear prefixes like 'get', 'set', 'list', and action verbs. All use camelCase uniformly, making them predictable and easy to parse.

    Tool Count2/5

    With 43 tools, the set feels excessive for controlling audio devices. Many tools could be consolidated (e.g., separate get/set for each audio parameter) without losing functionality, leading to a bloated interface that may overwhelm agents.

    Completeness5/5

    The tool set comprehensively covers the domain of Lyngdorf audio device control, including discovery, status retrieval, configuration (balance, bass, treble, etc.), playback management, and power operations. No obvious gaps exist for typical use cases.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server that wraps the Multiroom Audio Hub v2 REST API, providing 24 tools to control multiroom audio systems. Enables AI assistants to manage inputs, outputs, groups, routes, playback, and master mute.
      AGPL 3.0
    • A
      license
      Not graded
      quality
      C
      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.
      1
      MIT