What is Neteasemusic Mcp

NetEaseMusic-MCP is a Model Context Protocol (MCP) tool designed to work with the NetEase Cloud Music client, allowing AI to have limited control over music playback.

Use cases

Use cases include commands like ‘play daily recommendations’, ‘mute’, ‘set volume to 15%’, and ‘play song XXX’. It can also be integrated into AI systems to enhance music interaction.

How to use

To use NetEaseMusic-MCP, download the latest version from the Release section, extract it, and configure your MCP Client (like Visual Studio Code) with the appropriate settings. Ensure the NetEase Cloud Music client is not running before starting the MCP server.

Key features

Key features include play/pause control, song skipping, liking/disliking songs, volume adjustment, song search (currently only supports single song search), and daily recommended playlists.

Where to use

NetEaseMusic-MCP can be used in personal music listening environments, AI-assisted music control applications, and integration with development tools for enhanced user experience.

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 协议开源。

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