MCP VN Music Server
MCP Server âm nhạc Việt Nam chuẩn SSE, kết nối với mp3.mrhung.io.vn để dùng với Xiaozhi.me.
🚀 Cài đặt & Chạy
npm install
npm start📡 Kết nối Xiaozhi
Trong Xiaozhi.me → Add MCP → nhập URL server của bạn:
https://your-server.com/sse🛠️ MCP Tools
| Tool | Mô tả |
|---|---|
search_music | Tìm kiếm bài hát, ca sĩ Việt Nam |
play_music | Lấy link stream nhạc để phát |
get_top_charts | Danh sách nhạc hot/trending |
🔗 REST Endpoints (test nhanh)
| URL | Mô tả |
|---|---|
GET / | Thông tin server |
GET /sse | SSE connection (Xiaozhi kết nối vào đây) |
POST /messages?sessionId=xxx | Gửi MCP JSON-RPC |
GET /search?q=sontung | Tìm kiếm |
GET /play?id=ZW79ZBE8 | Stream nhạc |
GET /charts | Top charts |
GET /health | Health check |
📁 Cấu trúc
index.js - MCP server chính
package.json - Dependencies
.env - Biến môi trường (PORT, v.v.)🌐 Deploy lên Replit / Railway / Render
- Upload code lên
- Chạy
npm install && npm start - Lấy URL public (ví dụ:
https://mcp-music.replit.dev) - Vào Xiaozhi → Add MCP →
https://mcp-music.replit.dev/sse
💡 Ví dụ hỏi Xiaozhi
- *"Tìm bài hát Sơn Tùng"*
- *"Phát bài Lạc Trôi"*
- *"Cho tôi nghe nhạc hot hôm nay"*