tianyupaipai-cmd/netease-music-mcp

跨平台、隐私优先的网易云音乐 MCP：搜索、歌词、歌单与设备适配器

About netease-music-mcp

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

- Mac：全部通用能力；附带稳定的 macOS 网易云客户端控制。 - Windows：搜索、歌词、详情、歌单和 stdio/HTTP MCP 可用；本地播放 控制适配器尚未标记为稳定。 - Linux / VPS / NAS：适合托管远程 MCP；提供搜索、歌词、详情和歌单 能力，不负责操作桌面播放器。 - Android / iPhone / 新设备：使用支持远程 MCP 的客户端连接你自己 托管的 HTTPS 地址，即可使用通用能力。云端服务不能绕过手机系统权限 操控另一个 App；手机内切歌需要单独的本地伴侣程序。

- neteasestatus：报告运行平台和可用设备适配器。 - neteasesearch：匿名搜索歌曲。 - neteasesongdetail：读取歌曲详情。 - neteaselyrics：读取歌词、翻译和罗马音。 - neteaseplaylistauthstatus：检查歌单账号能力配置，不返回 Cookie。 - neteaseplaylistlist：列出当前账号创建的歌单。 - neteaseplaylistcreate：创建公开或隐私歌单。 - neteaseplaylistaddsongs：添加歌曲到指定歌单。 - neteaseplaylistremovesongs：从指定歌单移除歌曲。 - neteaselistentogethercapabilities：报告当前设备的一起听能力。

- neteaselaunch：启动官方客户端。 - neteaseopenentity：打开歌曲、歌单、专辑或歌手页面。 - neteaseopenarea：打开私人 FM、下载管理或听歌识曲。 - neteasecontrol：播放/暂停、上一首、下一首。 - neteasenexttrack：发送系统级下一首命令，不操控屏幕。 - neteaselistentogetherinvite：打开一起听邀请界面。

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

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

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

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

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

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

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/tianyupaipai-cmd--netease-music-mcp.html)

Related MCP servers