تكامل خادم TMDB MCP

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

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

قائمة القوالب الاستفهامية

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

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

• الأفلام (tmdb:///movie/<movie_id>)
  يوفر تفاصيل شاملة للفيلم، تشمل:
  • العنوان وتاريخ الإصدار
  • التقييم والملخص
  • الأنواع
  • رابط الملصق
  • معلومات الطاقم (أفضل 5 ممثلين)
  • المخرج
  • مراجعات مختارة
    جميع البيانات تُعرض بصيغة JSON.

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

• search_movies
  البحث عن الأفلام بعنوان أو كلمات مفتاحية. يُرجع قائمة أفلام مع العناوين، وسنوات الإصدار، والمعرفات، والتقييمات، والملخصات.

• get_recommendations
  الحصول على توصيات أفلام بناءً على معرف فيلم TMDB محدد. يُرجع أفضل 5 أفلام موصى بها مع التفاصيل.

• get_trending
  جلب الأفلام الرائجة لفترة زمنية محددة (“يوم” أو “أسبوع”). يُرجع أفضل 10 أفلام رائجة مع التفاصيل.

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

• اكتشاف واستكشاف الأفلام
  يمكن للمطورين تمكين المستخدمين من اكتشاف أفلام جديدة عن طريق استعلام قاعدة بيانات TMDB الشاسعة، مع إمكانية التصفية بالكلمات المفتاحية أو الأنواع أو الشعبية.

• توصيات مخصصة
  يمكن للمساعدات الذكية جلب توصيات أفلام بناءً على أفلام المستخدم المفضلة، مما يعزز التفاعل في تطبيقات الترفيه.

• مراقبة الاتجاهات
  يمكن للتطبيقات عرض الأفلام الرائجة (يوميًا أو أسبوعيًا)، لإبقاء المستخدمين على اطلاع بالمحتوى الشائع.

• جلب تفاصيل الأفلام
  يمكن للروبوتات أو المساعدات تقديم معلومات مفصلة عن الأفلام، بما في ذلك الطاقم، والمخرج، والمراجعات، والمزيد، لتعزيز الاستفسارات.

• تكامل روبوتات الدردشة الترفيهية
  دمج مع روبوتات الدردشة للإجابة عن أسئلة المستخدمين حول الأفلام، والممثلين، والإصدارات القادمة في الوقت الحقيقي.

كيفية الإعداد

Windsurf

1. تأكد من تثبيت Node.js (الإصدار 18+)، npm (الإصدار 8+)، وTypeScript.
2. احصل على مفتاح TMDB API من TMDB.
3. أضف خادم TMDB MCP إلى إعداداتك:

   {
     "mcpServers": {
       "tmdb": {
         "command": "npx",
         "args": ["@Laksh-star/mcp-server-tmdb@latest"]
       }
     }
   }
   

4. احفظ إعداداتك وأعد تشغيل Windsurf.
5. ضع مفتاح TMDB API في متغير بيئة لأمان أكبر:

   {
     "env": {
       "TMDB_API_KEY": "your_api_key_here"
     }
   }
   

6. تحقق من الإعداد بتنفيذ استعلام تجريبي.

Claude

1. تأكد من توفر المتطلبات (Node.js، npm، TypeScript) واحصل على مفتاح TMDB API.
2. عدّل ~/Library/Application Support/Claude/config.json ليشمل:

   {
     "mcpServers": {
       "tmdb": {
         "command": "npx",
         "args": ["@Laksh-star/mcp-server-tmdb@latest"]
       }
     }
   }
   

3. احفظ الإعدادات وأعد تشغيل Claude Desktop.
4. قم بتأمين مفتاح API باستخدام متغيرات البيئة:

   {
     "env": {
       "TMDB_API_KEY": "your_api_key_here"
     }
   }
   

5. تحقق من التكامل بالبحث عن فيلم.

Cursor

1. ثبت Node.js وnpm، واحصل على مفتاح TMDB API.
2. افتح إعدادات Cursor وابحث عن إعدادات خادم MCP.
3. أضف ما يلي:

   {
     "mcpServers": {
       "tmdb": {
         "command": "npx",
         "args": ["@Laksh-star/mcp-server-tmdb@latest"]
       }
     }
   }
   

4. استخدم متغير بيئة لمفتاح API:

   {
     "env": {
       "TMDB_API_KEY": "your_api_key_here"
     }
   }
   

5. احفظ وأعد تشغيل Cursor.

Cline

1. ثبت Node.js وnpm، واحصل على مفتاح TMDB API.
2. ابحث عن ملف إعدادات MCP في Cline.
3. أضف:

   {
     "mcpServers": {
       "tmdb": {
         "command": "npx",
         "args": ["@Laksh-star/mcp-server-tmdb@latest"]
       }
     }
   }
   

4. قم بتأمين مفتاح API:

   {
     "env": {
       "TMDB_API_KEY": "your_api_key_here"
     }
   }
   

5. احفظ، أعد تشغيل Cline، واختبر الخادم.

ملاحظة: تأكد دائمًا من حماية مفاتيح API الخاصة بك باستخدام متغيرات البيئة كما هو موضح أعلاه.

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

استخدام MCP في FlowHunt

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

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

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

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

نظرة عامة

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

تقييم MCP

التقييم:
استنادًا إلى الميزات المتاحة والكمال والتوثيق، يحصل هذا الخادم MCP على 7/10. إنه قوي لمهام الأفلام، لكن غياب القوالب ودعم أخذ العينات يقلل من قدرته على دعم تدفقات MCP أوسع.