mcp-server-bugpk-music

A Model Context Protocol server that wraps the BugPk music aggregation API, exposing song resolution (direct audio URL, cover, lyrics) as MCP tools for AI agents.

Supports QQ Music (tencent) and NetEase Cloud Music (netease).

Tools

• id: QQ Music uses the songmid/media_mid (e.g. 0039MnYb0qxYhV); NetEase uses the numeric song id.
• media: tencent | netease
• type: song | mv | url

Install & run

pip install mcp-server-bugpk-music
# or from source:
pip install -e .

# stdio (default) — what imcp.pro / Claude etc. use as a command
bugpk-music

# Streamable HTTP (self-host)
bugpk-music --transport http --port 8080

Client config example

{
  "mcpServers": {
    "bugpk-music": {
      "command": "uvx",
      "args": ["mcp-server-bugpk-music"]
    }
  }
}

Notes

• The BugPk aggregator depends on the upstream QQ / NetEase services. When its upstream is unstable it may return {"error":"API返回非JSON格式数据"}; the server passes that through transparently instead of crashing.
• When a song id is not found it returns {"code":0,"msg":"未找到对应数据"}.

License

MIT