qq-music-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| QQ_MUSIC_COOKIE | No | Cookie for accessing VIP content on QQ Music |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_musicB | 搜索 QQ 音乐 Args: keyword: 搜索关键词 search_type: 搜索类型，可选值: song(歌曲), album(专辑), playlist(歌单), mv, lyric(歌词), user(用户) page: 页码，从1开始 page_size: 每页数量，默认20 Returns: 搜索结果的 JSON 字符串 |
| get_song_detailA | 获取歌曲详情 Args: song_mid: 歌曲的 MID 标识符 Returns: 歌曲详情的 JSON 字符串，包含歌曲名、歌手、专辑、时长、可用音质等信息 |
| get_song_qualityA | 获取歌曲可用的音质列表 Args: song_mid: 歌曲的 MID 标识符 Returns: 可用音质列表的 JSON 字符串。音质类型包括: - m4a: AAC 格式 - 128: 128kbps MP3 - 320: 320kbps MP3 - flac: FLAC 无损 - ape: APE 无损 - hires: 臻品母带 (24bit/192kHz) - atmos: 臻品全景声 (Dolby Atmos) |
| get_lyricB | 获取歌词 Args: song_mid: 歌曲的 MID 标识符 Returns: 歌词的 JSON 字符串，包含原歌词和翻译歌词（如有） |
| get_song_urlA | 获取单首歌曲的播放链接 Args: song_mid: 歌曲的 MID 标识符 quality: 音质类型，可选值: - m4a: AAC 格式 - 128: 128kbps MP3 (默认) - 320: 320kbps MP3 - flac: FLAC 无损 - ape: APE 无损 - hires: 臻品母带 - atmos: 臻品全景声 Returns: 播放链接的 JSON 字符串。注意：高品质音源可能需要 VIP 权限 |
| get_batch_song_urlsA | 批量获取多首歌曲的播放链接 Args: mids: 多个歌曲 MID，用逗号分隔，例如 "mid1,mid2,mid3" quality: 音质类型，可选值: - m4a: AAC 格式 - 128: 128kbps MP3 (默认) - 320: 320kbps MP3 - flac: FLAC 无损 - ape: APE 无损 - hires: 臻品母带 - atmos: 臻品全景声 Returns: 播放链接列表的 JSON 字符串 |
| get_album_detailB | 获取专辑详情 Args: album_mid: 专辑的 MID 标识符 Returns: 专辑详情的 JSON 字符串，包含专辑名、歌手、发行日期、描述、歌曲数量等 |
| get_album_songsA | 获取专辑的歌曲列表 Args: album_mid: 专辑的 MID 标识符 Returns: 专辑歌曲列表的 JSON 字符串 |
| get_playlist_detailC | 获取歌单详情和歌曲列表 Args: playlist_id: 歌单 ID（数字） Returns: 歌单详情和歌曲列表的 JSON 字符串 |
| get_album_coverA | 获取专辑封面图片 URL Args: album_mid: 专辑的 MID 标识符 size: 图片尺寸，常用值: 150, 300, 500 Returns: 专辑封面图片的 URL |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
Most tools map to distinct resources and actions, but get_song_quality duplicates part of get_song_detail (which already includes available qualities), and get_album_cover is a subset of get_album_detail. This creates some ambiguity about which tool to use for quality/cover information.
All tool names follow a consistent verb_noun pattern in snake_case: search_music, get_song_detail, get_song_url, get_album_cover, etc. No mixed conventions.
10 tools falls comfortably in the ideal range for a music API server. Each tool addresses a specific aspect of music discovery, metadata, and playback without being bloated.
Core music workflows (search, song detail, quality, URL, lyrics, album info, playlist info) are covered. However, search_music supports MV and user searches but there are no corresponding get_mv_detail or get_user_profile tools, creating dead ends for those search types.