Skip to main content
Glama
avikmittro4-max

Music Search MCP Server

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

Related MCP Connectors

Related MCP Servers