luuu-h/netease-music-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

85 stars 10 forks 质量 75 趋势 19MIT

Repository Install

基于MCP的网易云音乐播放器：通过neteasecli和mpv播放网易云音乐音乐，并配有本地同步歌词网页播放器。

概览

一个用于控制本机音乐播放的 MCP Server。它通过 neteasecli 和本地 mpv 播放音乐，并提供一个本地歌词播放器 Web UI。本项目不是网易云音乐官方 MCP，也不隶属于、关联于或受网易云音乐官方认可。本项目仅用于个人学习、研究和本机自动化体验。使用时请合理遵守网易云音乐及相关服务的服务条款、版权规则和账号使用规范。本项目并非网易云音乐官方MCP，也与网易云音乐无关联、关联或认可。本项目旨在个人学习、研究和本地自动化实验。请负责任地使用，并遵守适用的网易云音乐服务条款、版权规则及账号使用政策。 - 搜索并播放网易云音乐歌曲 - 暂停、继续、停止、切歌 - 打开本地 Web 播放器：http://127.0.0.1:8765/ - 显示歌词、歌单、喜欢的音乐和黑胶播放页 - 在 AI 回复前读取当前歌曲、曲风、歌手和当前歌词上下文 - 结束听歌时一键停止 mpv 并关闭本次 Web 播放器需要上游项目：wangwalk/neteasecli。代码默认从 %APPDATA%\npm\node_modules 查找全局安装的 neteasecli。 mpv 是前置依赖，需要提前安装，并确保在 PowerShell 里可以直接运行 mpv --version。 neteasecli 和 mpv 都属于系统/全局依赖，不会被 npm install 自动安装。neteasecli 当前版本自身要求 Node.js 24 或更新版本，因此推荐直接使用 Node.js 24+ 跑整个项目。如果你使用的是 Windows 便携版 mpv.exe，也可以临时放在项目根目录。先在浏览器里登录网易云音乐网页版。

概述（AI 翻译）

一个用于控制本机音乐播放的 MCP Server。它通过 neteasecli 和本地 mpv 播放音乐，并提供一个本地歌词播放器 Web UI。

免责声明 / 免责声明

本项目不是网易云音乐官方 MCP，也不隶属于、关联于或受网易云音乐官方认可。本项目仅用于个人学习、研究和本机自动化体验。使用时请合理遵守网易云音乐及相关服务的服务条款、版权规则和账号使用规范。

本项目并非网易云音乐官方MCP，也与网易云音乐无关联、关联或认可。本项目旨在个人学习、研究和本地自动化实验。请负责任地使用，并遵守适用的网易云音乐服务条款、版权规则及账号使用政策。

你可以让 Claude Desktop 这类 MCP 客户端帮你：

搜索并播放网易云音乐歌曲
暂停、继续、停止、切歌
打开本地 Web 播放器：[http://127.0.0.1:8765/
显示歌词、歌单、喜欢的音乐和黑胶播放页
在 AI 回复前读取当前歌曲、曲风、歌手和当前歌词上下文
结束听歌时一键停止 mpv 并关闭本次 Web 播放器

环境要求

本项目目前主要面向 Windows 使用。

依赖	要求	说明
Windows	推荐 Windows 10/11	当前主要在 Windows 上开发和测试
Node.js	24 或更新版本	`neteasecli` 当前版本自身要求 Node.js 24+
NPM	随 Node.js 安装	用于安装本项目依赖和全局 CLI
网易云音乐账号	可正常登录	`neteasecli` 会从浏览器导入 Cookie
`neteasecli`	全局安装	用于访问网易云音乐账号、搜索、歌单和歌曲信息
`mpv`	系统可执行文件	推荐加入系统 `PATH`，确保能运行 `mpv --version`

需要上游项目：wangwalk/neteasecli。

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

netease-music-mcp

一个用于控制本机音乐播放的 MCP Server。它通过 neteasecli 和本地 mpv 播放音乐，并提供一个本地歌词播放器 Web UI。

免责声明 / Disclaimer

This project is not an official NetEase Cloud Music MCP and is not affiliated with, associated with, or endorsed by NetEase Cloud Music. It is intended for personal learning, research, and local automation experiments. Please use it responsibly and comply with the applicable NetEase Cloud Music terms of service, copyright rules, and account usage policies.

你可以让 Claude Desktop 这类 MCP 客户端帮你：

搜索并播放网易云音乐歌曲
暂停、继续、停止、切歌
打开本地 Web 播放器：http://127.0.0.1:8765/
显示歌词、歌单、喜欢的音乐和黑胶播放页
在 AI 回复前读取当前歌曲、曲风、歌手和当前歌词上下文
结束听歌时一键停止 mpv 并关闭本次 Web 播放器

环境要求

本项目目前主要面向 Windows 使用。

依赖	要求	说明
Windows	推荐 Windows 10/11	当前主要在 Windows 上开发和测试
Node.js	24 或更新版本	`neteasecli` 当前版本自身要求 Node.js 24+
npm	随 Node.js 安装	用于安装本项目依赖和全局 CLI
网易云音乐账号	可正常登录	`neteasecli` 会从浏览器导入 Cookie
`neteasecli`	全局安装	用于访问网易云音乐账号、搜索、歌单和歌曲信息
`mpv`	系统可执行文件	推荐加入系统 `PATH`，确保能运行 `mpv --version`

需要上游项目：wangwalk/neteasecli。代码默认从 %APPDATA%\npm\node_modules 查找全局安装的 neteasecli。

mpv 是前置依赖，需要提前安装，并确保在 PowerShell 里可以直接运行 mpv --version。

neteasecli 和 mpv 都属于系统/全局依赖，不会被 npm install 自动安装。 neteasecli 当前版本自身要求 Node.js 24 或更新版本，因此推荐直接使用 Node.js 24+ 跑整个项目。如果你使用的是 Windows 便携版 mpv.exe，也可以临时放在项目根目录。

安装

克隆项目：

git clone https://github.com/luuu-h/netease-music-mcp.git
cd netease-music-mcp

安装项目依赖：

npm install

全局安装音乐 CLI：

npm install -g neteasecli

先在浏览器里登录网易云音乐网页版。neteasecli 的登录方式是从浏览器导入 Cookie，不会在 MCP 里保存你的账号密码。

https://music.163.com/

然后在 PowerShell 里导入登录状态：

neteasecli auth login

如果你有多个 Chrome/Edge 浏览器 Profile，可以指定 Profile：

neteasecli auth login --profile "Profile 1"

确认登录状态：

neteasecli --pretty auth check

安装 mpv。任选一种你常用的方式即可：

# Chocolatey
choco install mpv -y

# Scoop
scoop install mpv

如果 PowerShell 提示找不到 neteasecli 命令，请确认 npm 全局命令目录已经加入 PATH。Windows 上通常是 %APPDATA%\npm。

检查安装

语法检查：

npm run check

Smoke test：

npm run smoke

smoke 会检查：

系统 PATH 或项目根目录里是否能找到 mpv
是否全局安装了 neteasecli

也可以在 MCP 客户端里让模型调用：

netease-music-mcp.check_environment

配置 Claude Desktop

Claude Desktop 通过 claude_desktop_config.json 注册本地 MCP Server。配置完成后，Claude 才能看到 netease-music-mcp 这些工具。

1. 确认项目绝对路径

在项目目录里运行：

pwd

假设输出是：

C:\Users\you\projects\netease-music-mcp

那么 MCP Server 文件路径就是：

C:\Users\you\projects\netease-music-mcp\src\server.js

2. 打开 Claude Desktop 配置文件

在 Windows 上打开 Claude Desktop 配置文件：

notepad "$env:APPDATA\Claude\claude_desktop_config.json"

如果提示找不到路径，先创建目录：

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

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