Music Search MCP Server (for XiaoZhi ESP32 Robot)

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

Tools এতে আছে

• search_music — গানের নাম দিয়ে search, top 5 result দেখাবে

• play_music — গানের নাম দিয়ে সবচেয়ে ভালো match খুঁজে সরাসরি playable URL দেবে

Related MCP server: YouTube MCP Server

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

npm install
npm start

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

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

1. এই পুরো ফোল্ডারটা একটা GitHub repo-তে push করুন (GitHub account লাগবে, ফ্রি)।

2. https://render.com এ গিয়ে ফ্রি account বানান।

3. New + → Web Service সিলেক্ট করুন।

4. আপনার GitHub repo connect করুন।

5. Settings এ:

   • Build Command: npm install

   • Start Command: npm start

   • Instance Type: Free

6. Deploy চাপুন। ২-৩ মিনিট পর একটা URL পাবেন, যেমন: https://music-search-mcp.onrender.com

আপনার MCP endpoint হবে:

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

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

1. https://railway.app এ account বানান (GitHub দিয়ে login করা যায়)

2. New Project → Deploy from GitHub repo

3. এই repo সিলেক্ট করুন — Railway automatic build/start করে নেবে

4. Settings → Networking → Generate Domain চেপে public URL নিন

5. MCP endpoint: https://<আপনার-app>.up.railway.app/mcp

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

1. xiaozhi.me → Console → আপনার Agent এ যান

2. Custom Services সেকশনে "Get MCP Endpoint" বাটনে ক্লিক করুন

3. উপরে যে URL পেয়েছেন (যেমন https://music-search-mcp.onrender.com/mcp) সেটা বসান

4. Save চাপুন

5. 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 লাগবে, যেটা একটু বেশি ধাপের।