netease-music-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NETEASE_MCP_CONFIG | No | Specify a local config file that contains no credentials; the plugin startup and preparation stages should use the same config | |
| NETEASE_MUSIC_STATE_DIR | No | Specify the state directory; must keep the same environment value in the setup and actual MCP/Codex processes |
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": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| netease_account_statusA | 验证网易云登录及会员状态,不返回凭据 |
| netease_searchA | 同时查找喜欢列表和公开曲库,返回 candidates 与各来源状态;query 只传歌名,已知歌手另传 artist,source=liked 只查收藏。缺失歌手不代表已匹配,不会自动播放 |
| netease_song_detailB | 读取歌曲信息和歌词,详情可见不代表具有播放权限 |
| netease_lyricsB | 读取用于显示的带时间戳歌词;不是播放状态 |
| netease_playlistsB | 读取当前账号的歌单摘要 |
| netease_playlist_tracksC | 分页读取歌单歌曲 |
| netease_liked_songsC | 分页读取我喜欢的音乐 |
| netease_statusA | 读取独立播放器真实位置和状态,verified=false时不可报告已播放 |
| netease_launchB | 准备独立播放引擎,不启动网易云桌面客户端 |
| netease_playC | 直接取流播放明确歌曲ID并验证真实进度 |
| netease_pauseB | 确保暂停,保留当前位置,重复暂停不会反向播放 |
| netease_resumeB | 继续当前歌曲,必要时刷新已过期的音频地址 |
| netease_stopA | 立即停止并卸载音频、归零进度,保留队列;会取消尚未完成的点歌 |
| netease_seekB | 定位到歌曲中的秒数;暂停状态定位后仍保持暂停 |
| netease_volumeA | 按用户明确目标设置播放器音量0到100,成功后保存供重启或升级恢复;不改变系统主音量,保存失败会明确报错 |
| netease_queueA | 读取当前队列摘要及当前位置之后至多五首ID |
| netease_nextC | 播放队列下一首 |
| netease_previousC | 播放队列上一首 |
| netease_play_likedC | 建立我喜欢的音乐队列并开始播放 |
| netease_play_playlistC | 建立指定歌单队列并开始播放 |
| netease_play_dailyC | 播放账号今天的每日推荐歌曲 |
| netease_play_heart_modeB | 开启网易云心动模式;默认基于我喜欢的音乐,队列结束自动获取下一批推荐 |
| netease_play_hot_chartA | 识别并播放网易云热歌榜,不替换为其他榜单 |
| netease_likeA | 按明确意图喜欢或取消喜欢歌曲;liked为true/false,省略songId时使用当前歌曲,写入后读回验证 |
| netease_play_modeA | 切换顺序、随机或单曲循环,保留当前歌曲、进度和暂停状态;随机队列每首一次,单曲循环不阻止手动切歌 |
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 25 tools
Most tools have clearly distinct playback, library, account, or search purposes. Some overlap remains between generic playback and source-specific play tools, and between netease_song_detail and netease_lyrics, but descriptions generally resolve these boundaries.
All tools consistently use the netease_ prefix followed by snake_case names. Although some names are verb-led and others noun-led, the overall convention is predictable and easy to scan.
At 25 tools, the surface is at the heavy end for a music playback server. Several source-specific play tools could likely be consolidated, though each control still has a plausible role.
Core playback, queue navigation, search, lyrics, account status, and library browsing are well covered. Minor gaps exist around queue modification and playlist management, but the main agent workflows are supported.