项目简介 NetEaseMusic-MCP 是一个基于 Model Context Protocol (MCP) 的应用后端，它允许兼容 MCP 的大型语言模型 (LLM) 客户端（如 Visual Studio Code 中的 Copilot Agent）通过自动化控制网易云音乐 PC 客户端，实现对音乐播放、音量、搜索等功能的远程操作。

主要功能点 该 MCP 服务器为 LLM 客户端提供了以下与网易云音乐互动的功能：

播放/暂停: 控制当前音乐的播放或暂停状态。
切换歌曲: 播放列表中的上一曲或下一曲。
喜欢/取消喜欢: 对当前歌曲进行红心或取消红心操作。
音量调节: 设置网易云音乐的音量百分比（0-100）。
搜索歌曲: 根据关键词搜索歌曲，返回搜索结果列表信息（目前主要支持单曲搜索）。
播放搜索结果: 根据搜索结果的索引播放单曲。
播放全部搜索结果: 播放搜索到的所有歌曲，会替换当前播放列表。
播放每日推荐: 启动播放网易云音乐的每日推荐歌单，会替换当前播放列表。

运行环境要求

Windows 操作系统
已安装网易云音乐 PC 客户端（测试版本为 3.1.7，建议使用较新版本）
根据选择的版本，可能需要安装 .NET 9.0 运行时（Standalone 版本无需）。

安装步骤

访问项目的 GitHub Release 页面，下载最新版本的 NetEaseMusic-MCP 压缩包。根据需求选择 'Framework' 或 'Standalone' 版本。
将下载的压缩包解压到您计算机上的任意文件夹。
（可选）如果网易云音乐客户端或用于自动化的 ChromeDriver 未安装在默认位置，或者您需要自定义服务器的监听端口，请编辑解压目录下的 'appsettings.json' 文件进行相应配置。

MCP 客户端配置 NetEaseMusic-MCP 作为 MCP 服务器运行，需要被兼容 MCP 的客户端软件（如 Visual Studio Code、Claude Desktop 等）发现和连接。您需要在您的 MCP 客户端设置中添加此服务器的配置。具体的配置方式因客户端而异，但核心信息包括：

服务器名称 (Server Name): 为此 MCP 服务器实例指定一个标识名称，例如 'netease-music-mcp'。
启动命令 (Command): 指定 NetEaseMusic-MCP 可执行文件的完整路径，例如 'D:\NetEaseMusic-MCP\NetEaseMusic-MCP.exe' (请替换为您的实际路径)。
启动参数 (Arguments): 通常保持为空列表 '[]'。配置完成后，当客户端需要与此 MCP 服务器交互时，它会自动启动 'NetEaseMusic-MCP.exe' 进程，并使用 Stdio 协议进行通信。请注意，为了确保正常启动，建议在启动 MCP 服务器之前关闭网易云音乐客户端，服务器会自动负责启动它。

基本使用方法 在 MCP 客户端中成功配置并启动 NetEaseMusic-MCP 服务器后，集成的 LLM Agent 就能够利用其暴露的工具功能。您可以尝试通过自然语言向 AI 发出指令，例如：

"帮我播放每日推荐歌单"
"把网易云音乐静音"
"将音量调到 75%"
"搜索周杰伦的晴天"
"播放搜索结果中的第一首歌" AI 会解析您的指令，并通过 MCP 协议调用 NetEaseMusic-MCP 服务器中对应的工具方法来执行操作。

关键词

信息