Content
NetEaseMusic-MCP
NetEaseMusic-MCP is) tool designed to work with the NetEase Music client, allowing AI to have limited control over NetEase Music.
## Supported Platforms
- Windows
## Provided Tools
- **Play/PNext Track**
- **Favorite/Unfavorite**
- **Volume Control**: Get volume, adjust volume
- **Search**: Currently supports single song, playlist, and album search.
- **Daily Recommendation**: Play daily recommended songs.
- **Playlist**: Clear playlist, currently does not support retrieval.
- **Current Playback**: Get the name and artist of the currently playing or paused song.
## Runtime Requirements
- .NET 9.0 SDK or runtime (not required for StandEase Music client (tested.7)
## Usage Guide
1. Download the latest version from Release, extract to any directory for later use.
?
- Framework: Smaller package, requires .NET 9.0 runtime installation
- StandAlone: Larger 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
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 `Start` above netease-music-mcp in the editor.<br/>
After a few seconds, NetEase Music will launch automatically.
7. Use in Copilot Agent mode.
Here's a complete settings.json example:
```JSON
{
"security.allowedUNCHosts": [
" "github.copilot.nextEditSuggestions.enabled": true,
"mcp": {
"inputs": [],
"servers": {
"netease-music-mcp": {
"command": "D:\\\\NetEaseMusic-MCP.exe",
"args": [],
}
}
}
}
```
## Configuration Options
Configuration options are located in the same directory as the executable file, in appsettings.json.
### UseDynamicPort
Whether to use dynamic port.<br/>
Enable to automatically find available port availability.
### StaticPort
Static port number.<br/>
Used when UseEaseMusicPath
Path to NetEase Music need to fill if usingDriverPath
Directory of ChromeDriver executable need to fill if custom Chrome What can it do?
, the application has limited scenarios,**"Play daily recommendation"**<br/>
**"Mute"**<br/>
song"**<br/>
**"Play daily recommendation"**<br/>
**"Current player status"**<br/>
Feel I close the NetEase Music window?
Closing usually doesn't affect usage. If issues arise, keep it open (no need to keep it in the foreground).
### macOS version?
Consider cross-platform support when 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 disagree with this data immediately.
### Do I need to restart NetEase Music when restarting MCP?
If you need to restart MCP you don't need to restart Net, if dynamic port is enabled, you need to exit NetEase Music first.
## Known Issues
- There Desktop, but it doesn't affect usage (log output cannot be identifiedource License
This project is open-sourced under the MIT license, except for the following cases:
- **Prohibited**, viruses, or 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.
cc-switch
All-in-One Assistant for Claude Code, Codex & Gemini CLI across platforms.
git
A Model Context Protocol server for Git automation and interaction.
oh-my-opencode
Background agents · Curated agents like oracle, librarians, frontend...
TrendRadar
TrendRadar: Your hotspot assistant for real news in just 30 seconds.
Appwrite
Build like a team of hundreds