خادم Spotify MCP

ماذا يفعل خادم “Spotify” MCP؟

خادم Spotify MCP (بروتوكول سياق النماذج) هو أداة صممت لربط المساعدين الذكاء الاصطناعي، مثل LLMs، بواجهة برمجة تطبيقات Spotify الواسعة. من خلال عمله كوسيط، يمكّن تدفقات العمل المدعومة بالذكاء الاصطناعي من التحكم في تشغيل Spotify، والبحث عن المقاطع، والألبومات، والفنانين، أو القوائم، واسترجاع معلومات مفصلة، وإدارة قوائم المستخدمين وقوائم الانتظار. تتيح هذه الإمكانية للمطورين ومستخدمي الذكاء الاصطناعي دمج بيانات الموسيقى والتحكم في التشغيل بسلاسة في تطبيقاتهم، مما يؤدي إلى أتمتة إدارة الموسيقى، وتنظيمها، واستكشافها. كما يعزز تدفقات التطوير من خلال توفير وصول موحد إلى ميزات Spotify، مما يسهل بناء وكلاء أذكياء يتفاعلون ديناميكياً مع المحتوى الموسيقي.

قائمة القوالب المقترحة

لا توجد قوالب مطالبات مذكورة في المستودع.

قائمة الموارد

لا توجد موارد MCP صريحة موثقة في المستودع.

قائمة الأدوات

• بدء التشغيل: يبدأ تشغيل مقطع أو قائمة تشغيل على حساب Spotify المتصل.
• إيقاف التشغيل مؤقتاً: يوقف جلسة التشغيل الحالية مؤقتاً.
• تخطي التشغيل: ينتقل إلى المقطع التالي في قائمة التشغيل.
• بحث: يتيح البحث عن المقاطع أو الألبومات أو الفنانين أو القوائم.
• جلب المعلومات: يسترجع معلومات حول مقطع أو ألبوم أو فنان أو قائمة معينة.
• إدارة قائمة الانتظار: يضيف المقاطع إلى قائمة تشغيل Spotify.
• إدارة القوائم: يمكّن من إنشاء وتحديث قوائم المستخدمين.

حالات استخدام هذا الخادم MCP

• التحكم في تشغيل الموسيقى: أتمتة والتحكم في التشغيل مباشرة من خلال الذكاء الاصطناعي، مثل تشغيل أو إيقاف الموسيقى أو تخطي المقاطع أو إدارة قائمة الانتظار، ما يفيد بشكل كبير في البيئات التي تعتمد على الأوامر الصوتية أو التدفقات المؤتمتة.
• اكتشاف الموسيقى والبحث: السماح لوكلاء الذكاء الاصطناعي بالبحث في كتالوج Spotify عن الأغاني أو الألبومات أو الفنانين أو القوائم، مما يتيح بناء محركات توصية أو ميزات استكشاف الموسيقى داخل التطبيقات.
• إدارة القوائم: تمكين الوكلاء الأذكياء من إنشاء وتحديث وتنظيم قوائم التشغيل للمستخدمين، ودعم التوصيات الشخصية والتحديثات الروتينية للقوائم.
• استرجاع معلومات الموسيقى: جلب بيانات وصفية مفصلة حول المقاطع أو الألبومات أو الفنانين أو القوائم، والتي يمكن استخدامها لتحليل الموسيقى أو التقارير أو التوصيات السياقية.
• إدارة قائمة الانتظار: يمكن للذكاء الاصطناعي إدارة وتحديث قائمة التشغيل ديناميكياً، وإضافة أو إزالة مقاطع وفقاً لتفضيلات المستخدم أو الإشارات السياقية.

كيفية إعداده

Windsurf

لا توجد تعليمات إعداد خاصة بـ Windsurf.

Claude

1. المتطلبات المسبقة: احصل على بيانات اعتماد واجهة برمجة تطبيقات Spotify (معرف العميل، السر، عنوان إعادة التوجيه) من لوحة تحكم مطوري Spotify.
2. استنساخ المستودع:

   git clone https://github.com/varunneal/spotify-mcp.git
   

3. تحرير ملف الإعداد: افتح ملف إعداد Claude Desktop:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
4. إضافة خادم MCP: أضف مقتطف JSON التالي في قسم mcpServers:

   "spotify": {
     "command": "uv",
     "args": [
       "--directory",
       "/path/to/spotify_mcp",
       "run",
       "spotify-mcp"
     ],
     "env": {
       "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",
       "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
       "SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8080/callback"
     }
   }
   

5. الحفظ وإعادة التشغيل: احفظ الملف وأعد تشغيل Claude Desktop.
6. التحقق: تأكد من توفر خادم Spotify MCP في واجهة Claude.

Cursor

لا توجد تعليمات إعداد خاصة بـ Cursor.

Cline

لا توجد تعليمات إعداد خاصة بـ Cline.

تأمين مفاتيح API

يتم تخزين بيانات الاعتماد عبر متغيرات البيئة في إعداد JSON:

"env": {
  "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",
  "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
  "SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8080/callback"
}

كيفية استخدام هذا MCP داخل التدفقات

استخدام MCP في FlowHunt

لدمج خوادم MCP في تدفق عمل FlowHunt الخاص بك، ابدأ بإضافة مكون MCP إلى التدفق وربطه بوكيل الذكاء الاصطناعي الخاص بك:

انقر على مكون MCP لفتح لوحة الإعدادات. في قسم إعدادات نظام MCP، أدخل تفاصيل خادم MCP الخاص بك مستخدماً هذا الشكل من JSON:

{
  "spotify": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

بعد الإعداد، سيتمكن وكيل الذكاء الاصطناعي من استخدام هذا MCP كأداة والتمتع بجميع وظائفه وإمكاناته. تذكر تغيير “spotify” إلى اسم خادم MCP الفعلي الخاص بك واستبدال عنوان URL بعنوان خادم MCP الخاص بك.

نظرة عامة

رأينا

يقدم خادم Spotify MCP إمكانيات عملية لتكامل الموسيقى، مع إعداد واضح لـ Claude ودعم شامل للأدوات فيما يتعلق بالتشغيل والبحث. إلا أن غياب قوالب المطالبات والموارد الصريحة ودعم العينات/الجذور يقلل من قابليته للتمدد بالنسبة للمستخدمين المتقدمين في MCP.

درجة MCP