NetEaseMusic-MCP

NetEaseMusic-MCP 是一个配合网易云音乐客户端使用的 Model Context Protocol (MCP) 工具，可以让 AI 对网易云音乐进行有限的控制。

支持平台

• Windows

提供的工具

• 播放/暂停
• 上一曲/下一曲
• 红心/取消红心
• 音量调节：获取音量、调节音量
• 搜索：目前支持单曲、歌单、专辑搜索。
• 每日推荐：播放每日推荐。
• 播放列表：清空播放列表，暂不支持获取。
• 当前播放：获取当前正在播放或暂停的歌曲名和歌手。

运行环境要求

• .NET 9.0 SDK 或运行时（StandAlone 版本不需要）
• 网易云音乐客户端（测试版本为 3.1.7）

使用指南

1. 从 Release 下载最新版本，解压到任意目录待后续使用。 如何选择版本？
   • Framework：包体小，需要安装 .NET 9.0 运行时
   • StandAlone：包体大，无需运行时
2. 配置你的 MCP Client（Visual Studio Code、Claude Desktop、...）。

配置 Visual Studio Code（Windows）

1. 打开 Visual Studio Code 的设置项（Ctrl + ,）
2. 在设置搜索中，搜索 mcp
3. 在搜索结果中，点击 Edit in settings.json
4. 添加 mcp 服务器

"netease-music-mcp": {
    "command": "PATH/TO/NetEaseMusic-MCP.exe",
    "args": [],
}

5. 确保网易云音乐未在运行。
6. 点击编辑器中，netease-music-mcp 上方显示的 Start。
   几秒后，将会自动启动网易云音乐。
7. 在 Copilot Agent 模式下使用。

以下为完整 settings.json 示例

{
    "security.allowedUNCHosts": [
        "wsl.localhost"
    ],
    "github.copilot.nextEditSuggestions.enabled": true,
    "mcp": {
        "inputs": [],
        "servers": {
            "netease-music-mcp": {
                "command": "D:\\NetEaseMusic-MCP\\NetEaseMusic-MCP.exe",
                "args": [],
            }
        }
    }
}

配置项

配置项位于可执行文件相同目录下，appsettings.json。

UseDynamicPort

是否使用动态端口。
开启后自动寻找可用端口，在本地环境无法保证特定端口可用的情况下开启。

StaticPort

静态端口号。
UseDynamicPort 为 false 时使用。

NetEaseMusicPath

网易云音乐客户端路径。
如果使用默认安装，则不用填写。

ChromeDriverPath

ChromeDriver 可执行文件所在目录。
如果不需要自定义 ChromeDriver，则不用填写。

常见问题

它能做什么？

单独使用此应用时，应用场景有限，比如可以让 AI 帮助你：

"播放每日推荐"
"静音"
"音量 15%"
"播放 XXX 的歌"
"播放每日推荐"
"当前播放器状态"

欢迎提供更多的使用场景。

网易云音乐窗口可以关闭吗？

关闭通常来说不影响使用。如果遇到问题，请保持打开（无需保持前台）。

macOS 版本？

功能相对完善后再考虑跨平台。

数据安全吗？

应用本身不会上传任何数据。
播放状态、音量、歌单等数据在需要时会提供给 AI，如果不同意此数据的共享，请立即停止使用。

重启 MCP 要重启网易云音乐吗？

如果要重启 MCP Server 或 MCP Client，可以不用重启网易云音乐。
但是如果开启了动态端口，那么需要先退出网易云音乐。

已知问题

• 在 Claude Desktop 中会有报错，但不影响使用（日志输出无法识别）。

开源协议

除以下情况外，本项目基于 MIT 协议开源。

• 禁止用于木马病毒等非法用途。
• 禁止用于任何危害网易云音乐权益的项目。