音乐服务器

MCP VN音乐服务器为越南音乐提供SSE标准连接,支持与Xiaozhi.me集成,提供音乐搜索、播放和排行榜功能。

  • by ducdoan-04
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 ducdoan-04/server-mcp-music-vn-xiaozhi-ai

使用说明

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

  1. Upload code lên
  2. Chạy npm install && npm start
  3. Lấy URL public (ví dụ: https://mcp-music.replit.dev)
  4. 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� � �