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

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

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

TDQS

A3.7/5.0

Scored across 13 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: environment checks, playback controls, search and play via ID or query, status, context, and session management. No significant overlap.

Naming Consistency4/5

Most tools follow a verb_noun pattern (e.g., play_song, search_song), but a few like 'next_song' (adjective_noun) and 'shutdown' (single verb) deviate slightly.

Tool Count5/5

13 tools cover the essential functionality of a music player (search, play, control, status, login) without being excessive.

Completeness4/5

Core playback and search are complete, but missing volume control and playlist management represent minor gaps.

Maintenance

ActivityInactive
ResponsivenessNo issues