Skip to main content
Glama
Music Search MCP Server

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers