Music Search Server

БесплатноНе проверен

Enables searching and playing music from YouTube, returning top results or playable URLs, designed for XiaoZhi ESP32 robot.

автор: avikmittro4-max

GitHub Embed

Описание

Enables searching and playing music from YouTube, returning top results or playable URLs, designed for XiaoZhi ESP32 robot.

README

এই সার্ভারটা YouTube থেকে গান/মিউজিক search করে link/info দেয়। XiaoZhi robot এটাকে MCP tool হিসেবে ব্যবহার করে "গান বাজাও" বললে গান খুঁজে দেবে।

Tools এতে আছে

search_music — গানের নাম দিয়ে search, top 5 result দেখাবে
play_music — গানের নাম দিয়ে সবচেয়ে ভালো match খুঁজে সরাসরি playable URL দেবে

দেশে (Local) টেস্ট করার নিয়ম

npm install
npm start

সার্ভার চালু হবে http://localhost:3000/mcp এ।

ফ্রি hosting-এ Deploy করার নিয়ম (Render.com দিয়ে, সবচেয়ে সহজ)

এই পুরো ফোল্ডারটা একটা GitHub repo-তে push করুন (GitHub account লাগবে, ফ্রি)।
https://render.com এ গিয়ে ফ্রি account বানান।
New + → Web Service সিলেক্ট করুন।
আপনার GitHub repo connect করুন।
Settings এ:
- Build Command: npm install
- Start Command: npm start
- Instance Type: Free
Deploy চাপুন। ২-৩ মিনিট পর একটা URL পাবেন, যেমন: https://music-search-mcp.onrender.com

আপনার MCP endpoint হবে:

https://music-search-mcp.onrender.com/mcp

Railway.app দিয়ে Deploy (বিকল্প, আরেকটু দ্রুত)

https://railway.app এ account বানান (GitHub দিয়ে login করা যায়)
New Project → Deploy from GitHub repo
এই repo সিলেক্ট করুন — Railway automatic build/start করে নেবে
Settings → Networking → Generate Domain চেপে public URL নিন
MCP endpoint: https://<আপনার-app>.up.railway.app/mcp

XiaoZhi Console-এ যোগ করার নিয়ম

xiaozhi.me → Console → আপনার Agent এ যান
Custom Services সেকশনে "Get MCP Endpoint" বাটনে ক্লিক করুন
উপরে যে URL পেয়েছেন (যেমন https://music-search-mcp.onrender.com/mcp) সেটা বসান
Save চাপুন
Robot restart করুন — এখন "একটা গান বাজাও" বললে robot search_music/play_music tool ব্যবহার করে গান খুঁজে বলবে

গুরুত্বপূর্ণ নোট

এই সার্ভার শুধু গান খুঁজে URL/info দেয় — আসল audio playback ESP32 নিজে করতে হবে (যদি ESP32-এ speaker/audio decode করার ক্ষমতা থাকে) অথবা XiaoZhi platform নিজে থেকে সেই লিংক থেকে audio stream করে ESP32-তে পাঠাবে (এটা XiaoZhi-এর firmware/agent কনফিগের উপর নির্ভর করে)।
Render-এর ফ্রি tier কিছুক্ষণ inactive থাকলে "sleep" করে, প্রথম request-এ কয়েক সেকেন্ড দেরি হতে পারে — এটা সমস্যা না, স্বাভাবিক।
চাইলে আমি Spotify-ভিত্তিক সংস্করণও বানিয়ে দিতে পারি, কিন্তু তাতে Spotify Developer App + OAuth setup লাগবে, যেটা একটু বেশি ধাপের।

from github.com/avikmittro4-max/music-mcp-server

Установка Music Search Server

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/avikmittro4-max/music-mcp-server

FAQ