{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_nf4azahrja6h","handle":"mcp-server-bugpk-music","url":"https://wellknown.network/agents/mcp-server-bugpk-music","links":{"self":"https://wellknown.network/agents/mcp-server-bugpk-music/record.json","html":"https://wellknown.network/agents/mcp-server-bugpk-music","markdown":"https://wellknown.network/agents/mcp-server-bugpk-music/record.md","api":"https://wellknown.network/api/v1/agents/mcp-server-bugpk-music","status":"https://wellknown.network/api/v1/agents/mcp-server-bugpk-music/status","claim":"https://wellknown.network/agents/mcp-server-bugpk-music/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-server-bugpk-music/claim.json","badge":"https://wellknown.network/agents/mcp-server-bugpk-music/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-server-bugpk-music/history","tools":"https://wellknown.network/api/v1/agents/mcp-server-bugpk-music/tools"},"ard":{"identifier":"urn:air::server:mcp-server-bugpk-music","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-server-bugpk-music","summary":"MCP server that wraps the BugPk music aggregation API (QQ Music / NetEase) for song resolution.","description":"# mcp-server-bugpk-music\n\nA [Model Context Protocol](https://modelcontextprotocol.io) server that wraps the\n[BugPk music aggregation API](https://api.bugpk.com/doc-music.html), exposing song\nresolution (direct audio URL, cover, lyrics) as MCP tools for AI agents.\n\nSupports **QQ Music** (`tencent`) and **NetEase Cloud Music** (`netease`).\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `resolve_music(id, media, type)` | Core resolver. Returns name / url / cover / author / lyrics |\n| `resolve_song(id, media)` | Structured song fields only |\n| `fetch_lyrics(id, media)` | LRC lyrics only |\n\n- `id`: QQ Music uses the `songmid`/`media_mid` (e.g. `0039MnYb0qxYhV`); NetEase uses the numeric song id.\n- `media`: `tencent` | `netease`\n- `type`: `song` | `mv` | `url`\n\n## Install & run\n\n```bash\npip install mcp-server-bugpk-music\n# or from source:\npip install -e .\n```\n\n```bash\n# stdio (default) — what imcp.pro / Claude etc. use as a command\nbugpk-music\n\n# Streamable HTTP (self-host)\nbugpk-music --transport http --port 8080\n```\n\n## Client config example\n\n```json\n{\n  \"mcpServers\": {\n    \"bugpk-music\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-server-bugpk-music\"]\n    }\n  }\n}\n```\n\n## Notes\n\n- The BugPk aggregator depends on the upstream QQ / NetEase services. When its\n  upstream is unstable it may return `{\"error\":\"API返回非JSON格式数据\"}`; the server\n  passes that through transparently instead of crashing.\n- When a song id is not found it returns `{\"code\":0,\"msg\":\"未找到对应数据\"}`.\n\n## License\n\nMIT","publisher":{"name":"Ocean Li","url":null},"homepage":null,"repository":null,"version":"0.1.1","license":null,"protocols":["mcp"],"tags":["mcp","music","qqmusic","netease","bugpk","model-context-protocol"],"pricing":null,"endpoints":[{"url":"pypi:mcp-server-bugpk-music","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"media.music","name":"Music & Audio","confidence":1,"provenance":"declared"}],"categories":["media"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-server-bugpk-music","registry":"pypi","observedAt":"2026-11-03T15:23:15.986Z","publishedAt":"2026-10-26T08:33:45.977493Z","latestVersion":"0.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-server-bugpk-music","url":"https://pypi.org/project/mcp-server-bugpk-music/","firstSeenAt":"2026-10-28T13:23:09.018Z","fetchedAt":"2026-11-03T15:21:58.782Z","normalizedAt":"2026-11-03T15:21:58.782Z"}]},"firstSeenAt":"2026-10-28T13:23:09.018Z","updatedAt":"2026-11-03T15:23:15.986Z"}