Denon AVR

Denon MCP 服务

英文摘要。 用于通过本地 telnet 控制协议控制 Denon AVR 家庭影院接收器的 MCP 服务：电源、音量、静音、输入源、状态。使用 DENON_HOST / DENON_PORT 配置（可选的 DENON_MAC 用于在 DHCP 更改 IP 后追踪接收器），也可使用 config.yaml；可独立运行（发布到 PyPI 后执行 uvx denon-mcp）。

用于通过 Denon AVR Control（telnet）协议控制 Denon AVR 家庭影院的 MCP 服务。

演示

使用实际功放录制，录制脚本为 docs/demo/record.sh：一个最精简的 MCP 客户端（docs/demo/mcp_demo.py）通过环境变量中的 DENON_HOST，以 stdio 模式启动服务，列出工具并调用 get_status（只读）。

支持的型号

• Denon AVR-X1700H DAB
• 其他兼容 Denon AVR Control 协议的 AVR-X 系列型号

配置

解析顺序：环境变量，然后是 YAML 文件（DENON_CONFIG；否则为 ./config.yaml；否则为服务所在目录中的 config.yaml；否则为服务安装在 Lyra 目录结构中时使用 Lyra 的配置）。服务可独立运行，无需 Lyra。

如果未预留 DHCP 地址，也请填写 mac（或 DENON_MAC）：如果 IP 不再响应，服务会在本地网络的邻居表中通过 MAC 地址查找 Denon（最多每 2 分钟查找一次），并切换到新的 IP。

一行安装

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

Claude Desktop / Claude Code 配置（mcpServers）：

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

添加到 config.yaml：

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

以下值仅为示例：请替换为设备的实际值 （功放网络菜单中显示的 IP，以及格式为 AA:BB:CC:DD:EE:FF 的 MAC 地址， 适用于 DHCP 地址预留或 Wake-on-LAN）。

可用工具

工具	作用
volume_set	将 Denon 音量设为指定级别（0-98）。80 = 0 dB 参考音量。
volume_up	提高 Denon 音量。
volume_down	降低 Denon 音量。
mute_on	开启 Denon 静音。
mute_off	关闭 Denon 静音。
mute_toggle	切换 Denon 静音状态（开/关）。
power_on	打开 Denon AVR。
power_off	关闭 Denon AVR（待机）。
get_status	返回 Denon 状态：音量、电源（开机/待机/未知）、静音状态、输入源（BD、TV、GAME 等）、是否可访问。
set_input	更改 Denon 输入源（BD、TV、GAME、SAT/CBL、DVD、MPLAY）。

输入源

• BD：蓝光 / BD 播放器
• TV：TV 输入
• GAME：游戏机
• SAT/CBL：卫星 / 有线电视
• DVD：DVD 播放器
• MPLAY：媒体播放器

支持的别名：bluray、blu-ray、cable、sat、media、mediaplayer

音量刻度

• 0-98：Denon 刻度（0 = -80 dB，80 = 0 dB 参考音量，98 = +18 dB）
• 日常聆听：30-50
• 家庭影院：50-70
• 建议的最大值：80（0 dB）

Denon AVR Control 协议

端口 23 上的 telnet 命令：

• MV44：音量设为 44
• MV?：查询当前音量
• MVUP / MVDOWN：音量 +/-
• PWON / PWSTANDBY：电源开/关
• MUON / MUOFF：静音开/关
• SIBD：蓝光输入源

HDMI ARC 说明

当家庭影院通过 HDMI ARC/eARC 连接到 TV 时：

• TV 音量会被禁用
• 由家庭影院控制音量
• tv.volume_* 命令不起作用
• 请改用 denon.volume_*

手动测试

# 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

安装

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/)

代码位于 denon_mcp 包中：它可以与其他 MCP 服务一起安装，且不会发生模块名冲突。 Lyra 会通过 MCP 配置自动启动该服务。

Lyra 生态系统的一部分

仓库	作用
lyra	语音 DevOps 助手，默认在本地运行（AGPL-3.0）
fedora-agents	MCP：KVM 虚拟机和备份
mcp-tracking	MCP + API + 长时间运行任务的仪表板
neutroncore	家庭实验室的 PWA 中枢
hue-mcp	Philips Hue MCP（基于 ThomasRohde/hue-mcp 的分支）
pylips-mcp	Philips 电视 MCP
denon-mcp	Denon 功放 MCP
catt-mcp	Chromecast 和 DLNA MCP