neteasecli [mpv]]]] mpv]]] [1]] [1]]] [1] [1]]] [1] [1]]] [1] [1]] [1]] [1] [1]] [1] [1] [1]] [1]] [1 [1] [1]] [1]] [1]] [1] [1] [1] [1]] [1] [1]] [1]] [1 [1] [1]] [1 [1]] [1 [1]]] [1 [1]] [1]]]]]] [1 [1 [1 [1 [1 [1 [1]]] [1 [1]]] [1 [1]]]]] [1 [1 [1 [1]]]] [1]]]]]] [1 [1 [1 [2]]] [1 [1]]] [1 [1]]]]]]] [1 [1 [1 [1]]]]] [

免責事項

版 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关 关

本プロジェクトは、NetEase Cloud Music MCP の公式アカウントではありません。また、NetEase Cloud Music に関連付けられているか、または支持されているとは関係ありません。 個人的な学習、研究、現地の自動化実験を目的とする。 該当するNetEase Cloud Music利用規約、著作権規則、およびアカウント利用ポリシーを遵守し、責任を持ってご利用ください。

你 端 端 端 端 端 端

歌唱歌曲

• 暂、停止、停止、、
• 焼成本地 Web 播放器:http://127.0.0.1:8765/ 显 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 乐 在 在 在 在 前 前 前 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和 和
• 次本次Web播種器

境

本画面目前 主面方向 Windows の使用。

| 依 | 说 | 说 | 说 | 说 | 依 | 依 | 依 | 依 | 依 | 依 | 依 | 依 | 依 | 依 | 依 | 依 | 依 | 依 | 说 | 依 | 说 | 说 | 说 | 说 | 说 | 说 | 说 | 说 | 说 | 说 | 依 | 说 | 依 | 依 | 依 | 依 | 依 | 依 | 依 | 依 | 依 | 依 | 依 | 依 | 依 | 依 | 依 | 依 | | 依 | 依 | 依 | 依 | 依 | 依 | 依 | 依 | 依 | 依 | 依 | 依 | 依 | | | | | | | | | | | | | | | | | | | | | | | | お問い合わせ | | ウィンドウズ | 推荐 ウィンドウズ 10/11 | 前方 主在 ウィンドウズ 上和 | Node.js | 24 および更新版本 | [[neteasecli前版本公開 Node.js 24+ | | npm | 別れ Node.js 安装 | 安装本脚本 徹 全文 | | [[neteasecli] 会导器入クッキー | | [neteasecli | 全安政権 | 歌唱歌唱信息信息 | | [mpv | 医学系可読行文件 | 推荐系医学 [PATH]

上 上 上 上 上 上 上 上 上 上 上 上 上 上 上 上 上 上 上 上 上 上 上 上 上 上 上 上 上 上 上 上 上 上 。 。 上 上 。 。 。 。 。 上 。 。 。 。 。 。 。 。 。 。 。 。 。

netease-music-mcp

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

免责声明 / Disclaimer

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

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 使用。

需要上游项目：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"

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