netease-music-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NETEASE_PERSONAL_HOST | No | 个人模式监听的主机地址（默认 127.0.0.1） | 127.0.0.1 |
| NETEASE_PERSONAL_PORT | No | 个人模式监听的端口（默认 3304） | 3304 |
| NETEASE_MCP_COOKIE_FILE | No | 包含网易云登录 Cookie（MUSIC_U 和 __csrf）的文件路径 | |
| NETEASE_MCP_SECRET_FILE | No | 旧版HTTP模式所需的64位十六进制秘密文件路径 | |
| NETEASE_PERSONAL_ORIGIN | No | 个人远程MCP部署的公开基础URL，例如 https://music.example.com | |
| NETEASE_PERSONAL_STORE_FILE | No | 认证状态等存储文件的路径 | |
| NETEASE_PERSONAL_MASTER_KEY_FILE | No | 用于加密的主密钥文件路径 | |
| NETEASE_MCP_ACCOUNT_WRITE_ENABLED | No | 设为1以启用个人歌单写操作（默认0） | 0 |
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_playlist_auth_statusA | 只检查账号写入功能是否已启用、是否配置会话文件；不返回任何 Cookie 值。 |
| netease_playlist_listA | 使用本机登录会话列出当前账号拥有的歌单，供后续添加或移除歌曲。 |
| netease_playlist_createA | 在当前登录账号下创建公开或隐私歌单。必须在用户明确确认本次创建后调用。 |
| netease_playlist_add_songsA | 将 1–100 首歌曲加入当前账号拥有的指定歌单；修改前会再次校验歌单归属。 |
| netease_playlist_remove_songsA | 从当前账号拥有的指定歌单移除 1–100 首歌曲；必须明确确认，且会校验歌单归属。 |
| netease_playlist_get_songsA | 读取指定歌单（必须是当前账号拥有的）中的所有歌曲信息，包括歌曲ID、名称、歌手、专辑等。 |
| netease_statusA | 检查当前运行平台、远程能力和可用的本地播放器适配器；macOS 还会读取客户端状态。 |
| netease_searchA | 通过 music.163.com 的匿名只读接口搜索歌曲，不读取账号 Cookie。 |
| netease_song_detailA | 按网易云歌曲 ID 读取名称、歌手、专辑、时长和官方页面链接。 |
| netease_lyricsA | 按歌曲 ID 读取 LRC、翻译和罗马音歌词；不下载音频。 |
| netease_launchA | 通过 macOS 适配器启动已安装的官方网易云音乐客户端；其他平台会返回清晰的能力错误。 |
| netease_open_entityA | 通过 macOS 适配器在官方客户端中打开歌曲、歌单、专辑或歌手页面。 |
| netease_open_areaA | 打开私人 FM、下载管理或听歌识曲。只允许预设的 orpheus:// 路由。 |
| netease_listen_together_capabilitiesA | 检查当前设备的一起听能力。macOS 适配器可打开邀请；互动能力取决于网易云官方移动端。 |
| netease_listen_together_inviteA | 通过 macOS 适配器打开“一起听”邀请界面。调用前必须确认用户明确希望发起邀请；好友或分享方式由用户在客户端中选择。 |
| netease_next_trackA | 让 macOS 直接向当前网易云播放器发送下一首命令。仅用于普通播放，不操控屏幕，也不用于一起听房间。 |
| netease_controlA | 控制官方 Mac 客户端播放/暂停、上一首或下一首，需要 macOS 辅助功能权限。 |
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 17 tools
Most tools map to clearly distinct resource-action pairs: playlist operations, song metadata/search, lyrics, and macOS client controls are well separated. The main overlap is netease_next_track versus netease_control, which both cover the next-track action, and netease_status versus netease_playlist_auth_status are somewhat similar in name but distinct in purpose.
All tools use a consistent snake_case format with the netease_ prefix, which is readable and predictable. There are minor deviations: some names are noun-like (song_detail, lyrics, status) while others are verb-based (search, launch, playlist_create), but the overall pattern is still recognizable.
17 tools is slightly above the ideal range but reasonable for a server that covers playlist management, song discovery, lyrics, and macOS client control. Most tools are narrow and functional, though a few could potentially be consolidated without much loss.
Playlist management covers create, list, add, remove, and read operations, but lacks playlist rename or delete. Playback control is present, but there is no way to retrieve the current playing track or directly play a specific song, which are notable gaps for a music-focused server.