Metadata-Version: 2.4
Name: mcp-server-cxzja-qqmusic
Version: 0.1.0
Summary: MCP server for the 残像API QQ音乐 (QQ Music) search & playback API.
Author: Ocean Li
License-Expression: MIT
Keywords: mcp,music,qqmusic,cxzja,model-context-protocol
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp<2,>=1.2
Requires-Dist: requests>=2.32

# mcp-server-cxzja-qqmusic

MCP server exposing the 残像API QQ音乐 (QQ Music) search & playback API.

- Endpoint: `GET https://api.cxzja.cn/api/qqmusic`
- Auth: personal token via `CXZJA_TOKEN` env / `--token` arg / per-call `token`.

No token is baked into the package.

## Use

```bash
uvx mcp-server-cxzja-qqmusic --token=YOUR_TOKEN
# or rely on the CXZJA_TOKEN environment variable
```

## Tools

- `search_music(keyword, n, br)` — search QQ Music, return song info + play URL
- `get_song_url(song_name, n, br)` — song name -> ready-to-play direct https URL
- `resolve_music(song_id, br)` — resolve by QQ song mid
- `fetch_lyrics(keyword, n)` — search and return LRC lyrics
