English Français العربية

Denon AVR

Official registry Other

Control a Denon AVR home cinema receiver over telnet: power, volume, mute, input source, status.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package denon-mcp
Claude Code 
claude mcp add denon-avr -e 'DENON_HOST=<DENON_HOST>' -e 'DENON_PORT=23' -- uvx denon-mcp==0.3.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "denon-avr": {
            "command": "uvx",
            "args": [
                "denon-mcp==0.3.2"
            ],
            "env": {
                "DENON_HOST": "<DENON_HOST>",
                "DENON_PORT": "23"
            }
        }
    }
}

Environment variables

  • DENON_HOST required IP address of the Denon receiver
  • DENON_PORT Telnet port of the receiver

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Denon MCP Server
  2. Démo
  3. Modèle supporté
  4. Configuration
  5. Installation en une ligne
  6. Outils disponibles
  7. Sources d'entrée
  8. Échelle de volume
  9. Protocole Denon AVR Control
  10. Notes HDMI ARC
  11. Test manuel
  12. Installation
  13. Part of the Lyra ecosystem

Denon MCP Server

English summary. MCP server for Denon AVR home-cinema receivers over the local telnet control protocol: power, volume, mute, inputs, status. Configure with DENON_HOST / DENON_PORT (optional DENON_MAC to follow the receiver when DHCP changes its IP) or a config.yaml; runs standalone (uvx denon-mcp after PyPI publication).

Serveur MCP pour contrôler un Home Cinema Denon AVR via le protocole Denon AVR Control (telnet).

Démo

Enregistrée sur l'ampli réel avec docs/demo/record.sh : un client MCP minimal (docs/demo/mcp_demo.py) démarre le serveur en stdio avec DENON_HOST dans l'environnement, liste les outils et appelle get_status (lecture seule).

Modèle supporté

  • Denon AVR-X1700H DAB
  • Autres modèles AVR-X series compatibles avec le protocole Denon AVR Control

Configuration

Ordre de résolution : variables d'environnement, puis fichier YAML (DENON_CONFIG, sinon ./config.yaml, sinon config.yaml à côté du serveur, sinon celui de Lyra si le serveur est installé dans son arborescence). Le serveur fonctionne seul, sans Lyra.

Sans réservation DHCP, renseignez aussi mac (ou DENON_MAC) : si l'IP ne répond plus, le serveur retrouve le Denon par son adresse MAC dans la table de voisinage du réseau local (une recherche toutes les 2 min au plus) et bascule sur la nouvelle IP.

Installation en une ligne

uvx denon-mcp          # après publication sur PyPI ; en attendant : uvx --from git+https://github.com/amineutron/denon-mcp denon-mcp

Configuration Claude Desktop / Claude Code (mcpServers) :

{ "denon": { "command": "uvx", "args": ["denon-mcp"], "env": { "DENON_HOST": "192.0.2.22" } } }

Ajouter dans config.yaml :

denon:
  host: "192.0.2.10"        # IP du Denon (exemple)
  port: 23                   # Port telnet (default: 23)

Les valeurs ci-dessous sont des exemples : remplacez-les par les valeurs de votre appareil (IP affichée dans le menu réseau de l'ampli, adresse MAC au format AA:BB:CC:DD:EE:FF utile pour une réservation DHCP ou le Wake-on-LAN).

Outils disponibles

OutilRôle
volume_setRegle le volume du Denon a un niveau specifique (0-98). 80 = 0dB reference.
volume_upAugmente le volume du Denon.
volume_downBaisse le volume du Denon.
mute_onActive le mute du Denon.
mute_offDesactive le mute du Denon.
mute_toggleToggle le mute du Denon (on/off).
power_onAllume le Denon AVR.
power_offEteint le Denon AVR (standby).
get_statusRetourne le statut du Denon : volume, power (on/standby/unknown), muted, source (BD, TV, GAME...), reachable.
set_inputChange la source d'entree du Denon (BD, TV, GAME, SAT/CBL, DVD, MPLAY).

Sources d'entrée

  • BD : Blu-ray / Lecteur BD
  • TV : Entrée TV
  • GAME : Console de jeu
  • SAT/CBL : Satellite / Câble
  • DVD : Lecteur DVD
  • MPLAY : Media Player

Aliases supportés : bluray, blu-ray, cable, sat, media, mediaplayer

Échelle de volume

  • 0-98 : Échelle Denon (0 = -80 dB, 80 = 0 dB référence, 98 = +18 dB)
  • Pour une écoute normale : 30-50
  • Pour un home cinéma : 50-70
  • Maximum recommandé : 80 (0 dB)

Protocole Denon AVR Control

Commandes telnet sur port 23 :

  • MV44 : Volume 44
  • MV? : Demander le volume actuel
  • MVUP / MVDOWN : Volume +/-
  • PWON / PWSTANDBY : Power on/off
  • MUON / MUOFF : Mute on/off
  • SIBD : Source Blu-ray

Notes HDMI ARC

Quand un home cinéma est connecté en HDMI ARC/eARC à la TV :

  • Le volume de la TV est désactivé
  • C'est le home cinéma qui contrôle le volume audio
  • Les commandes tv.volume_* ne fonctionnent PAS
  • Utiliser denon.volume_* à la place

Test manuel

# Test connexion
echo "MV?" | nc 192.0.2.10 23

# Régler volume à 44
echo "MV44" | nc 192.0.2.10 23

# Allumer
echo "PWON" | nc 192.0.2.10 23

Installation

denon-mcp                     # installé (pip, uvx) ; `denon-mcp --help` liste les réglages
python -m denon_mcp           # équivalent, depuis tout environnement où le paquet est installé
python server.py              # depuis un clone, sans installation (lanceur minimal, code dans denon_mcp/)

Le code vit dans le paquet denon_mcp : il s'installe à côté d'autres serveurs MCP sans conflit de nom de module. Le serveur est automatiquement lancé par Lyra via la config MCP.

Part of the Lyra ecosystem

DépôtRôle
lyraassistant DevOps vocal, local par défaut (AGPL-3.0)
fedora-agentsMCP : machines virtuelles KVM et sauvegardes
mcp-trackingMCP + API + tableau de bord des tâches longues
neutroncorehub PWA du homelab
hue-mcpMCP Philips Hue (fork de ThomasRohde/hue-mcp)
pylips-mcpMCP TV Philips
denon-mcpMCP ampli Denon
catt-mcpMCP Chromecast et DLNA

Frequently asked questions

What is Denon AVR?

Control a Denon AVR home cinema receiver over telnet: power, volume, mute, input source, status.

How do I install Denon AVR?

It runs on your machine. In Claude Code: claude mcp add denon-avr -e 'DENON_HOST=<DENON_HOST>' -e 'DENON_PORT=23' -- uvx denon-mcp==0.3.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Denon AVR need an API key?

Yes. It expects DENON_HOST, which you set in its configuration.

Is Denon AVR open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Denon AVR?

It is published by amineutron. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.