xiaozhi-music-railway

Real music MCP WebSocket server for XiaoZhi AI — multi-platform music search & playable URLs via Meting.

Supported Platforms

• Netease — 网易云音乐 (music.163.com)
• Tencent — QQ音乐 (y.qq.com)
• Kugou — 酷狗音乐 (kugou.com)
• Kuwo — 酷我音乐 (kuwo.cn)

MCP Tools (JSON-RPC over WebSocket)

Tool	Description
platforms	List supported music platforms
search	Search songs/albums/artists by keyword
song	Get song details by ID
url	Get playable audio URL by song ID
album	Get album details by ID
artist	Get artist works by ID
playlist	Get playlist by ID
lyric	Get lyrics by song ID
pic	Get cover image URL

Deploy on Railway

1. Fork/push this repo to GitHub
2. Railway → New Project → Deploy from GitHub repo
3. Auto-detects Node.js, auto-deploys
4. Copy the domain → wss://your-app.up.railway.app

Environment Variables (optional)

For higher quality audio, set platform cookies:

• METING_NETEASE_COOKIE — Netease Cloud Music cookies
• METING_TENCENT_COOKIE — Tencent QQ Music cookies
• METING_KUGOU_COOKIE — KuGou Music cookies
• METING_KUWO_COOKIE — Kuwo Music cookies
• METING_COOKIE — fallback cookie for all platforms

XiaoZhi MCP Configuration

Add to your XiaoZhi MCP config:

{
  "endpoint": "wss://your-app.up.railway.app"
}