Ncm Cli Setup
安装和配置 ncm-cli（网易云音乐 CLI 工具）。当用户需要安装 ncm-cli、配置 API Key、安装 mpv 播放器，或排查安装问题时，使用此 skill。
by netease · Apache-2.0
The skill
安装和配置 ncm-cli（网易云音乐 CLI 工具）。当用户需要安装 ncm-cli、配置 API Key、安装 mpv 播放器，或排查安装问题时，使用此 skill。
ncm-cli 安装配置
ncm-cli 是网易云音乐的 CLI 工具（音乐搜索、播放控制、歌单管理、TUI 播放器）。
安装流程
第一步：安装 ncm-cli、mpv
1.1 安装 ncm-cli
npm install -g @music163/ncm-cli
验证安装：
ncm-cli --version
1.2 安装 mpv
播放功能需要 mpv 播放器。先检测是否已安装：
mpv --version
macOS / Windows：若未安装，直接执行安装脚本：
python3 scripts/install_mpv.py
Linux：询问用户是否需要播放功能：
- 如果是桌面环境、需要本地播放 → 执行
python3 scripts/install_mpv.py - 如果是服务器环境、不需要播放 → 跳过，搜索/歌单等命令仍可正常使用
安装脚本会自动识别包管理器：
- macOS：Homebrew（
brew install mpv）或 MacPorts - Linux：apt / dnf / pacman / zypper
- Windows：winget / Chocolatey / Scoop
第二步：配置 API Key
使用 ncm-cli 需要先设置API Key：
ncm-cli config set appId <你的AppId>
ncm-cli config set privateKey <你的PrivateKey>
如果还没有 API Key，请先前往网易云音乐开放平台申请 API Key（appId 和 privateKey）。
第三步：配置默认播放器
询问用户选择默认播放器：
- mpv（内置播放器）：轻量、跨平台，需先完成第一步中的 mpv 安装
- orpheus（云音乐 App）：调用本地网易云音乐客户端播放，仅支持 macOS
根据用户选择执行：
ncm-cli config set player mpv # 选择内置播放器
ncm-cli config set player orpheus # 选择云音乐 App
第四步：登录
登录是必须的，请使用：
ncm-cli login --background
常见问题
| 问题 | 解决方法 |
|---|---|
ncm-cli: command not found |
检查 npm 全局 bin 是否在 PATH 中：npm bin -g |
mpv not found |
重新运行 python3 scripts/install_mpv.py 或手动安装：https://mpv.io |
| 登录超时 | 重新执行 ncm-cli login --background |
基本信息
- 需要 Node.js >= 18
Use this skill
Connect your agent to the Skill Store MCP server and ask for it by ref: netease/ncm-cli-setup-41531549167.
Details
- Publisher
- netease
- Category
- Creative & Media › Audio & music
- License
- Apache-2.0
- Updated
- 2026-03-31
References
More from netease
- Netease Music Assistant 网易云音乐智能助手，以模型判断为核心，通过 ncm-cli 执行操作。 核心能力：分析用户红心歌单偏好画像、制定多关键词搜索策略、智能推荐歌单/专辑/单曲（含两层推荐说明）、播放控制（播放/暂停…
- Netease Music Cli 使用 ncm-cli 操作网易云音乐。当用户想播放歌曲、搜索歌曲、控制播放（暂停、下一首、上一首、调音量）、管理播放队列、查看播放状态、播放歌单时，使用此 skill。