NetEaseMusic-MCP

# 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.