lyrion-mcp

用于 Lyrion Music Server / Logitech Media Server 的 MCP 服务器。

它允许 AI 代理通过 LMS JSON-RPC API 检查和控制 LMS 播放器：播放器、播放、音量、播放列表、收藏、广播、库搜索和库浏览。

功能

服务器和播放器

• 测试 LMS 连接

• 读取服务器状态、版本、库统计信息和扫描进度

• 列出播放器

• 通过 LMS id、确切名称或唯一名称片段解析播放器

• 读取详细的播放器状态和当前播放列表

播放控制

• 播放、暂停、切换播放/暂停、停止

• 上一首 / 下一首

• 设置音量

• 电源开/关/切换

• 跳转到指定位置

• 睡眠定时器

• 随机播放和重复模式

• 同步 / 取消同步播放器

播放列表和播放源

• 显示当前播放列表

• 清除当前播放列表

• 按曲目 ID 加载/播放或追加库曲目

• 播放直接 URL/流

• 列出已保存的 LMS 播放列表

• 按播放列表 ID 播放已保存的播放列表

• 列出收藏

• 列出顶级广播提供商/类别

库浏览/搜索

• 搜索曲目、专辑和艺术家

• 列出流派、专辑、年份

• 浏览音乐文件夹

• 列出专辑的曲目

• 列出艺术家的专辑或曲目

• 触发 LMS 库重新扫描

诊断

• 只读原始 JSON-RPC 辅助工具，用于安全故障排除命令。

Related MCP server: lms-mcp

工具

• lms_test_connection

• lms_server_status

• lms_players

• lms_player_status

• lms_play, lms_pause, lms_play_pause, lms_stop

• lms_next, lms_previous

• lms_set_volume, lms_set_power

• lms_seek, lms_sleep

• lms_set_shuffle, lms_set_repeat

• lms_sync, lms_unsync

• lms_playlist, lms_clear_playlist

• lms_play_track, lms_add_track, lms_play_url

• lms_saved_playlists, lms_play_playlist

• lms_favorites, lms_radios

• lms_search_tracks, lms_search_albums, lms_search_artists

• lms_genres, lms_albums, lms_years

• lms_music_folder, lms_album_tracks, lms_artist_albums, lms_artist_tracks

• lms_rescan_library

• lms_raw_readonly

配置

环境变量：

Docker

docker build -t lyrion-mcp .
docker run --rm -p 8310:8310 \
  -e LMS_URL=http://host.docker.internal:9000/jsonrpc.js \
  lyrion-mcp

MCP 端点：

http://localhost:8310/sse

Docker Compose

services:
  lyrion-mcp:
    image: ghcr.io/simoneb79/lyrion-mcp:latest
    environment:
      LMS_URL: http://host.docker.internal:9000/jsonrpc.js
    ports:
      - "8310:8310"
    restart: unless-stopped

示例客户端配置

{
  "mcpServers": {
    "lyrion-mcp": {
      "url": "http://localhost:8310/sse"
    }
  }
}

备注

• 默认情况下，此服务器不需要 LMS 凭据，因为标准 LMS JSON-RPC 部署通常位于局域网内。请将其置于常规网络控制之后。

• 向 AI 代理公开播放控制可能会改变扬声器上正在播放的内容。请相应审查代理权限。

许可证

MIT