Netease Music Mcp

网易云音乐 MCP

一个隐私优先、可自托管的网易云音乐 Model Context Protocol 服务。它把 搜索、歌曲详情、歌词和个人歌单能力提供给任何支持 MCP 的客户端，同时把 本地播放器控制隔离在设备适配器中。

> 非网易云音乐官方项目，与网易公司无隶属或背书关系。

可以在哪些设备使用

• Mac：全部通用能力；附带稳定的 macOS 网易云客户端控制。
• Windows：搜索、歌词、详情、歌单和 stdio/HTTP MCP 可用；本地播放

控制适配器尚未标记为稳定。

• Linux / VPS / NAS：适合托管远程 MCP；提供搜索、歌词、详情和歌单

能力，不负责操作桌面播放器。

• Android / iPhone / 新设备：使用支持远程 MCP 的客户端连接你自己

托管的 HTTPS 地址，即可使用通用能力。云端服务不能绕过手机系统权限 操控另一个 App；手机内切歌需要单独的本地伴侣程序。

完整矩阵见 [Platform support](docs/PLATFORM_SUPPORT.md)。

工具

所有平台

• netease_status：报告运行平台和可用设备适配器。
• netease_search：匿名搜索歌曲。
• netease_song_detail：读取歌曲详情。
• netease_lyrics：读取歌词、翻译和罗马音。
• netease_playlist_auth_status：检查歌单账号能力配置，不返回 Cookie。
• netease_playlist_list：列出当前账号创建的歌单。
• netease_playlist_create：创建公开或隐私歌单。
• netease_playlist_add_songs：添加歌曲到指定歌单。
• netease_playlist_remove_songs：从指定歌单移除歌曲。
• netease_listen_together_capabilities：报告当前设备的一起听能力。

macOS 本地适配器

• netease_launch：启动官方客户端。
• netease_open_entity：打开歌曲、歌单、专辑或歌手页面。
• netease_open_area：打开私人 FM、下载管理或听歌识曲。
• netease_control：播放/暂停、上一首、下一首。
• netease_next_track：发送系统级下一首命令，不操控屏幕。
• netease_listen_together_invite：打开一起听邀请界面。

快速开始

需要 Node.js 20 或更高版本。

git clone https://github.com/tianyupaipai-cmd/netease-music-mcp.git
cd netease-music-mcp
npm ci
npm test
npm start

npm start 使用 stdio，适合本机 MCP 客户端。通用配置示例：

{
  "mcpServers": {
    "netease-music": {
      "command": "node",
      "args": ["/absolute/path/to/netease-music-mcp/src/server.js"]
    }
  }
}

这不是某一个 AI 产品的专用格式；任何支持 stdio MCP 的桌面端或自建前端 都可以使用同一个服务。

远程 HTTP 与手机连接

先创建只允许当前用户读取的 64 位十六进制秘密：

mkdir -p ~/.netease-music-mcp
openssl rand -hex 32 > ~/.netease-music-mcp/http.secret
chmod 600 ~/.netease-music-mcp/http.secret
NETEASE_MCP_SECRET_FILE="$HOME/.netease-music-mcp/http.secret" npm run start:http

服务默认只监听 127.0.0.1:3303。请在它前面使用你自己的 HTTPS 反向代理 或零信任隧道，然后把最终地址 https://your-domain.example/mcp/ 加入支持 Streamable HTTP MCP 的客户端。

不要直接监听公网，不要提交或分享完整 MCP URL。手机可以连接这个远程地址， 但 Mac 睡眠或托管服务器停止后服务也会离线。

可选：启用个人歌单

账号写入默认关闭。项目不读取密码，只从指定文件加载 MUSIC_U 和可选 __csrf：

MUSIC_U=你的值; __csrf=你的值

然后配置：

export NETEASE_MCP_ACCOUNT_WRITE_ENABLED=1
export NETEASE_MCP_COOKIE_FILE=/absolute/path/to/netease.session

macOS 用户可在官方客户端登录后运行：

npm run import:session:macos

脚本只保存白名单 Cookie，不打印秘密值。POSIX 系统要求会话文件权限为 600；Windows 请把文件 ACL 限制为当前用户。创建、添加和移除歌曲工具 仍要求本次调用显式传入 confirm: true。

安全和边界

• 不保存账号密码，Cookie、.env、会话文件和秘密文件均被 Git 忽略。
• 账号写工具默认关闭，且只能修改当前会话账号拥有的歌单。
• 不提供音频下载、解密、会员绕过或版权限制规避。
• 不调用私有聊天接口，也不自动发送一起听消息。
• macOS 播放控制可能需要“隐私与安全性 → 辅助功能/自动化”授权。
• netease_next_track 使用系统媒体命令，不读取画面或点击坐标，但只保证

普通播放模式；一起听房间是否接受切歌由官方客户端决定。

披露安全问题前请阅读 [SECURITY.md](SECURITY.md)。

开发

npm ci
npm test

CI 在 macOS、Windows 和 Linux 的 Node.js 20/22 上运行。欢迎提交平台 适配器，但未在目标设备实测的能力必须标为实验性。

License

[MIT](LICENSE)

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: tianyupaipai-cmd
• Source: tianyupaipai-cmd/netease-music-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.