netease-music-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | Optional port for HTTP mode. | |
| HTTPS_PROXY | No | Optional HTTPS proxy URL used by Node.js when NODE_USE_ENV_PROXY=1. | |
| MCP_AUTH_TOKEN | No | Optional auth token for HTTP mode. If unset, a random token is generated and printed in the logs for the current run. | |
| NETEASE_COOKIE | No | Optional NetEase Cloud Music cookie, usually the MUSIC_U value or a full cookie string, used as an alternative to QR-code login. | |
| NODE_USE_ENV_PROXY | No | Set to 1 to make Node.js use environment proxy settings such as HTTPS_PROXY when connecting to NetEase servers. | |
| NETEASE_COOKIE_FILE | No | Optional path to the file where login state is saved. Defaults to ~/.netease-music-mcp/cookie.json. |
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 |
|---|---|
| searchC | 在网易云音乐中搜索歌曲、专辑、歌手、歌单、用户、歌词或播客（电台）。 |
| get_song_detailA | 根据歌曲 ID 批量获取歌曲信息（歌名、歌手、专辑、时长、是否 VIP）。 |
| get_lyricsA | 获取歌曲歌词，包括原文、中文翻译和罗马音（如果有）。 |
| get_playlistB | 获取歌单信息和其中的歌曲（支持分页）。排行榜也可以用这个工具查看。 |
| get_albumB | 获取专辑信息和曲目列表。 |
| get_artistC | 获取歌手简介和热门歌曲，可选附带专辑列表。 |
| get_toplistsA | 获取网易云所有官方排行榜（飙升榜、新歌榜、热歌榜、原创榜等）。用 get_playlist 查看某个榜单的歌曲。 |
| get_commentsA | 获取歌曲 / 歌单 / 专辑 / MV 的评论。第一页会附带热门评论。 |
| get_similar_songsB | 根据一首歌获取网易云推荐的相似歌曲。 |
| login_qr_startA | 生成网易云音乐登录二维码。把二维码展示给用户（返回的图片，或把 qr_text 原样放进代码块），请用户用网易云音乐 App 扫码并在手机上确认，然后调用 login_qr_check。 |
| login_qr_checkA | 检查二维码登录状态。可设置 wait_seconds 在服务器端等待用户扫码（每 2 秒轮询一次），登录成功后自动保存登录状态。 |
| get_login_statusA | 查看当前是否已登录网易云音乐，以及登录账号的基本信息。 |
| logoutA | 清除本连接器保存的网易云登录状态。 |
| get_user_playlistsA | 获取用户创建和收藏的歌单（默认当前登录用户；他人的公开歌单也可以查）。 |
| get_liked_songsA | 获取用户“喜欢”的歌曲（默认当前登录用户），和 App 里“我喜欢的音乐”歌单顺序一致：最近喜欢的在前，附带喜欢的日期。 |
| get_daily_recommendationsA | 获取当前登录用户的每日推荐歌曲（需要登录）。 |
| get_recommended_playlistsA | 获取为当前登录用户推荐的歌单（需要登录）。 |
| get_listening_historyB | 获取用户的听歌排行（最近一周或所有时间）。他人的听歌排行可能因隐私设置不可见。 |
| like_songA | 把歌曲加入（或移出）当前用户的“我喜欢的音乐”。会修改用户账号，调用前请确认。 |
| create_playlistA | 在当前用户账号下新建一个歌单，返回歌单 ID。之后可用 update_playlist_tracks 添加歌曲。会修改用户账号，调用前请确认。 |
| update_playlist_tracksA | 向当前用户自己创建的歌单添加或移除歌曲。会修改用户账号，调用前请确认。 |
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 21 tools
Most tools target distinct resources (song, album, artist, playlist, comments, login). The playlist family (get_playlist, get_user_playlists, get_toplists, get_liked_songs) and the like_song vs get_liked_songs pair could momentarily confuse, but descriptions clearly differentiate read vs. write and ownership semantics.
Strong consistent verb_noun snake_case pattern (get_song_detail, create_playlist, update_playlist_tracks, like_song). Minor deviations are bare verbs 'search' and 'logout', which are still readable and conventional.
21 tools is at the heavy end for a music client and borders on being sprawling. Each tool serves a plausible purpose, but some (get_similar_songs, get_toplists) could arguably fold into existing tools.
Covers search, song/lyrics detail, album, artist, playlists, ranking, comments, similarity, auth lifecycle, and playlist mutation. Gaps remain around playlist deletion/renaming, MV/video detail, and podcast episode-level access, but core workflows are covered.