使用说明
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" #� �s�e�r�v�e�r�-�m�c�p�-�m�u�s�i�c�-�v�n�-�x�i�a�o�z�h�i�-�a�i� � �