Content
# NetEaseMusic-MCP
NetEaseMusic-MCP is an Model Context Protocol (MCP) tool designed to work with the NetEase Music client, allowing AI to have limited control over NetEase Music.
## Supported Platforms
- Windows
## Provided Tools
- **Play/Pause**
- **Previous/Next Track**
- **Favorite/Unfavorite**
- **Volume Control**: Get volume, adjust volume
- **Search**: Currently supports single song, playlist, and album search.
- **Daily Recommendation**: Play daily recommendation.
- **Playlist**: Clear playlist, currently does not support retrieval.
- **Current Playback**: Get the currently playing or paused song name and artist.
## Operating Environment Requirements
- .NET 9.0 SDK or runtime (StandAlone version does not require)
- NetEase Music client (tested version is 3.1.7)
## Usage Guide
1. Download the latest version from Release, extract to any directory for later use.
How to choose a version?
- Framework: Small package, requires .NET 9.0 runtime installation
- StandAlone: Large package, no runtime required
2. Configure your MCP Client (Visual Studio Code, Claude Desktop, ...).
### Configure Visual Studio Code (Windows)
1. Open Visual Studio Code settings (Ctrl + ,)
2. Search for `mcp` in settings search
3. Click `Edit in settings.json` in search results
4. Add MCP server
```JSON
"netease-music-mcp": {
"command": "PATH/TO/NetEaseMusic-MCP.exe",
"args": [],
}
```
5. Ensure NetEase Music client is not running.
6. Click `Start` above netease-music-mcp in the editor.<br/>
After a few seconds, NetEase Music will launch automatically.
7. Use in Copilot Agent mode.
The following is a complete settings.json example
```JSON
{
"security.allowedUNCHosts": [
"wsl.localhost"
],
"github.copilot.nextEditSuggestions.enabled": true,
"mcp": {
"inputs": [],
"servers": {
"netease-music-mcp": {
"command": "D:\\NetEaseMusic-MCP\\NetEaseMusic-MCP.exe",
"args": [],
}
}
}
}
```
## Configuration Options
Configuration options are located in the same directory as the executable file, appsettings.json.
### UseDynamicPort
Whether to use dynamic port.<br/>
Enable to automatically find available ports when local environment cannot guarantee specific port availability.
### StaticPort
Static port number.<br/>
Used when UseDynamicPort is false.
### NetEaseMusicPath
NetEase Music client path.<br/>
If using default installation, no need to fill.
### ChromeDriverPath
Directory of ChromeDriver executable file.<br/>
If no custom ChromeDriver is needed, no need to fill.
## Frequently Asked Questions
### What can it do?
When used alone, the application scenarios are limited, for example, AI can help you:
**"Play daily recommendation"**<br/>
**"Mute"**<br/>
**"Volume 15%"**<br/>
**"Play XXX's song"**<br/>
**"Play daily recommendation"**<br/>
**"Current player status"**<br/>
Feel free to provide more usage scenarios.
### Can the NetEase Music window be closed?
Closing usually does not affect use. If encountering issues, please keep it open (no need to keep it in the foreground).
### macOS version?
Consider cross-platform after features are relatively complete.
### Is data safe?
The application itself does not upload any data.<br/>
Playback status, volume, playlist, and other data are provided to AI when needed. If you disagree with this data sharing, please stop using immediately.
### Do I need to restart NetEase Music when restarting MCP?
If you need to restart MCP Server or MCP Client, you do not need to restart NetEase Music.<br/>
However, if dynamic port is enabled, you need to exit NetEase Music first.
## Known Issues
- There will be errors in Claude Desktop, but it does not affect use (log output cannot be identified).
## Open Source License
Except for the following situations, this project is open-sourced under the MIT license.
- **Prohibited** for use in Trojan horses, viruses, and other illegal purposes.
- **Prohibited** for use in any projects that harm NetEase Music's interests.
Connection Info
You Might Also Like
awesome-mcp-servers
A collection of MCP servers.
git
A Model Context Protocol server for Git automation and interaction.
cc-switch
All-in-One Assistant for Claude Code, Codex & Gemini CLI across platforms.
TrendRadar
TrendRadar: Your hotspot assistant for real news in just 30 seconds.
oh-my-opencode
Background agents · Curated agents like oracle, librarians, frontend...
Appwrite
Build like a team of hundreds