TMDB MCP Sunucu Entegrasyonu

“TMDB” MCP Sunucusu ne yapar?

TMDB MCP Sunucu, AI asistanlarını The Movie Database (TMDB) API’siyle buluşturarak kapsamlı film bilgisine, arama yeteneklerine ve film önerilerine sorunsuz erişim sağlar. AI istemcileri ile TMDB arasında bir köprü görevi gören bu sunucu; başlığa veya anahtar kelimeye göre film arama, belirli filmler hakkında detaylı bilgi çekme, trend filmleri veya kişiselleştirilmiş önerileri alma gibi görevleri mümkün kılar. Bu entegrasyon, eğlence temalı uygulama, chatbot veya asistan özellikleri geliştiren geliştiricilerin iş akışlarını kolaylaştırır; AI sistemlerinin film veritabanı sorgulaması, bağlamsal bilgi yönetimi ve TMDB kaynaklarıyla programlı olarak etkileşime geçmesini sağlar. TMDB MCP Sunucu, AI ajanlarının TMDB’den film verisine erişimini ve sunumunu standartlaştırıp basitleştirerek geliştirme süreçlerini iyileştirir.

Komut Listesi

Mevcut dokümantasyonda komut şablonları belirtilmemiştir.

Kaynak Listesi

• Filmler (tmdb:///movie/<movie_id>)
  Kapsamlı film detayları sunar, örneğin:
  • Başlık ve çıkış tarihi
  • Puan ve özet
  • Türler
  • Poster URL’si
  • Oyuncu bilgisi (en iyi 5 oyuncu)
  • Yönetmen
  • Seçilmiş yorumlar
    Tüm veriler JSON formatında döner.

Araçlar Listesi

• search_movies
  Başlığa veya anahtar kelimelere göre film arayın. Film başlıkları, çıkış yılları, kimlikleri, puanları ve özetleriyle bir liste döndürür.

• get_recommendations
  Belirli bir TMDB film kimliğine göre film önerileri alın. Detaylarıyla birlikte en iyi 5 önerilen filmi döndürür.

• get_trending
  Belirtilen zaman aralığı (“day” veya “week”) için trend olan filmleri alın. Detaylarıyla birlikte en iyi 10 trend filmi döndürür.

Bu MCP Sunucusunun Kullanım Alanları

• Film Keşfi ve Araştırması
  Geliştiriciler, kullanıcıların TMDB’nin geniş veritabanında yeni filmler keşfetmesini; anahtar kelime, tür veya popülerliğe göre filtreleme yapmasını sağlayabilir.

• Kişiselleştirilmiş Öneriler
  AI asistanları, kullanıcının favori filmlerine göre öneriler sunarak eğlence uygulamalarında kullanıcı etkileşimini artırabilir.

• Trend Takibi
  Uygulamalar, günlük veya haftalık trend filmleri göstererek kullanıcıları popüler içerikler hakkında bilgilendirebilir.

• Film Detay Sorgulama
  Botlar veya asistanlar, oyuncu, yönetmen, yorumlar ve daha fazlası dahil olmak üzere detaylı film bilgisi sunarak kullanıcı sorgularını zenginleştirebilir.

• Eğlence Chatbot Entegrasyonu
  Chatbotlara entegre ederek, kullanıcılara filmler, oyuncular ve yaklaşan vizyonlar hakkında gerçek zamanlı yanıtlar verebilirsiniz.

Nasıl Kurulur

Windsurf

1. Node.js (v18+), npm (v8+) ve TypeScript’in kurulu olduğundan emin olun.
2. TMDB üzerinden bir TMDB API anahtarı alın.
3. TMDB MCP Sunucusu’nu yapılandırmanıza ekleyin:

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

4. Yapılandırmanızı kaydedin ve Windsurf’u yeniden başlatın.
5. Güvenlik için TMDB API anahtarınızı ortam değişkeni olarak ayarlayın:

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

6. Kurulumu bir test sorgusuyla doğrulayın.

Claude

1. Gereksinimleri doğrulayın (Node.js, npm, TypeScript) ve bir TMDB API anahtarı alın.
2. ~/Library/Application Support/Claude/config.json dosyasını şununla güncelleyin:

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

3. Yapılandırmayı kaydedin ve Claude Desktop’u yeniden başlatın.
4. API anahtarınızı ortam değişkeniyle güvenli şekilde ekleyin:

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

5. Bir film arayarak entegrasyonu doğrulayın.

Cursor

1. Node.js, npm yükleyin ve bir TMDB API anahtarı edinin.
2. Cursor ayarlarını açıp MCP sunucu yapılandırmasını bulun.
3. Şu bölümü ekleyin:

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

4. API anahtarını ortam değişkeni olarak kullanın:

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

5. Kaydedin ve Cursor’u yeniden başlatın.

Cline

1. Node.js, npm’i kurun ve TMDB API anahtarınızı alın.
2. Cline’da MCP yapılandırma dosyasını bulun.
3. Şunu ekleyin:

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

4. API anahtarını güvenli şekilde ekleyin:

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

5. Kaydedin, Cline’ı yeniden başlatın ve sunucuyu test edin.

Not: API anahtarlarınızı yukarıda gösterildiği gibi her zaman ortam değişkenleriyle güvenli tutun.

Bu MCP’yi akışlarda nasıl kullanırsınız

FlowHunt’ta MCP Kullanımı

Akışınıza MCP sunucuları entegre etmek için önce MCP bileşenini ekleyin ve AI ajanınıza bağlayın:

MCP bileşenine tıklayarak yapılandırma panelini açın. Sistem MCP yapılandırma bölümüne, aşağıdaki JSON formatında MCP sunucu detayınızı ekleyin:

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

Yapılandırma tamamlandığında, AI ajanı bu MCP’yi tüm işlevleriyle ve yetenekleriyle bir araç olarak kullanabilir. “tmdb” adını kendi MCP sunucu adınız ile ve URL’yi kendi MCP sunucu adresinizle değiştirmeniz gerektiğini unutmayın.

Genel Bakış

Bizim görüşümüz:
Bu MCP sunucusu güçlü film verisi araçları ve net kurulum talimatları sunuyor, ancak komut şablonları ve örnekleme desteği yok. Eğlence ve film asistanı kullanım senaryoları için oldukça uygun, fakat ek MCP özellikleriyle daha kapsamlı olabilir.

MCP Puanı

Puan:
Mevcut özellikler, tamlık ve dokümantasyona göre bu MCP sunucusu 7/10 puan alıyor. Filmle ilgili görevler için sağlam, ancak komut ve örnekleme desteğinin eksikliği daha geniş MCP tabanlı iş akışlarında çok yönlülüğünü azaltıyor.