Skip to main content
Glama
luuu-h

netease-music-mcp

by luuu-h

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
check_environmentB

Check neteasecli, mpv, and login status.

setup_netease_loginA

Use this when the user needs to set up, log in, or troubleshoot neteasecli. It checks installation/login state and returns step-by-step commands Claude can guide the user through.

search_songA

Search songs using neteasecli and return normalized NetEase track IDs.

play_songA

Search for a song, play the best match with neteasecli/mpv, and return song info plus listening context. The style field is filled from NetEase song wiki when available.

play_trackC

Play a NetEase numeric song ID with neteasecli/mpv and return song info plus the start listening context. The style field is filled from NetEase song wiki when available.

next_songB

Switch to another requested song by searching and playing it. Use this for natural-language '切歌'.

pauseA

Pause current neteasecli/mpv playback.

resumeA

Resume paused neteasecli/mpv playback.

stopA

Stop current neteasecli/mpv playback and clear listening state.

shutdownA

Use this when the user asks to end the listening session, stop listening to music, close the player, or stop the music program. It stops mpv playback, clears listening state, and closes the current web player server, while keeping the MCP tool process alive for future calls.

get_statusB

Get current neteasecli/mpv playback status plus cached song metadata.

get_listening_contextA

Return the context that the AI should include on the next user message while music is playing. The lyric context is the next 6 lyric lines at or after the current playback time.

open_web_playerB

Generate and serve a local web player UI for search/play/pause/stop and lyric context. Returns a localhost URL.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/luuu-h/netease-music-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server