music-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MUSIC_MCP_DB_PATH | No | SQLite 索引路径 | ./library.db |
| MUSIC_MCP_LOG_LEVEL | No | 日志级别 | INFO |
| MUSIC_MCP_LYRICS_DIR | No | 歌词存储目录；设置后 get_lyrics 自动写 {artist} - {title}.lrc，无需音频文件存在。留空则歌词只写在与音频同目录（需音频已存在） | |
| MUSIC_MCP_DOWNLOAD_DIR | No | 歌曲下载目录（download_song 不传 target_dir 时用此值） | ./downloads |
| MUSIC_MCP_NETEASE_COOKIE | No | 网易云登录 cookie（可选，如 MUSIC_U=...） | |
| MUSIC_MCP_NETEASE_TIMEOUT | No | 网易云请求超时（秒） | 10.0 |
| MUSIC_MCP_NETEASE_MIN_INTERVAL_MS | No | 网易云请求最小间隔（ms） | 800 |
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
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_songsC | 按关键词搜索歌曲，返回标题/歌手/专辑/来源/是否已入库。 |
| download_songB | 下载歌曲到本地。传 norm_key（来自搜索结果）或 title+artist。 target_dir 省略时用 MUSIC_MCP_DOWNLOAD_DIR 配置。 |
| get_lyricsA | 获取歌词（LRC 优先）。传 norm_key 或 title+artist。 audio_dir 提供时写同名 .lrc；否则用 MUSIC_MCP_LYRICS_DIR 配置写 .lrc。 |
| scan_libraryC | 扫描本地音频目录，补元数据并触发歌词补全。 |
| query_libraryC | 查询本地库，可按关键词和有无歌词过滤。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
The tools are mostly distinct: search finds remote songs, download fetches them, get_lyrics retrieves lyrics, scan and query operate on the local library. Search/download/get_lyrics relate to remote content while scan/query relate to local content; these boundaries are fairly clear. The only minor overlap is that download and get_lyrics both accept the same identifying params, but their purposes differ.
All five tools follow a consistent verb_noun pattern: search_songs, download_song, get_lyrics, scan_library, query_library. The verbs and nouns are unambiguous and consistently styled in snake_case.
Five tools is a reasonable, compact set for a music management server. It could arguably benefit from a couple more operations (e.g., remove/delete songs), but the current count is well-scoped for the apparent purpose.
The surface covers search, download, lyrics retrieval, library scanning, and querying. Minor gaps include no delete/remove tool for downloaded songs or library entries, and no play or status operation, but core workflows are covered and agents can accomplish primary tasks.