TMDB MCP サーバー

このプロジェクトは、The Movie Database (TMDB) APIと統合されたModel Context Protocol (MCP)サーバーを実装します。これにより、ClaudeのようなAIアシスタントが映画データと対話し、検索、詳細情報の取得、映画関連コンテンツの生成などの機能を提供できるようになります。

特徴

リソース

• 静的リソース:

  • tmdb://info - TMDB APIに関する情報

  • tmdb://trending - 現在トレンドの映画

• リソーステンプレート:

  • tmdb://movie/{id} - 特定の映画に関する詳細情報

プロンプト

• 映画レビュー: 指定されたスタイルと評価でカスタマイズされた映画レビューを生成します

• 映画のおすすめ: ジャンルや気分に基づいてパーソナライズされた映画のおすすめを入手できます

ツール

• 映画を検索: タイトルまたはキーワードで映画を検索

• トレンド映画を取得: 日ごとまたは週ごとのトレンド映画を取得します

• 類似映画を取得: 指定した映画に類似した映画を検索します

セットアップ手順

前提条件

• Node.js (v16以降)

• npmまたはyarn

• TMDB APIキー

インストール

1. このリポジトリをクローンする

   git clone https://github.com/your-username/tmdb-mcp.git cd tmdb-mcp

2. 依存関係をインストールする

   npm install

3. TMDB APIキーを設定する

   • プロジェクトルートに.envファイルを作成します (代替案: src/config.tsを直接編集します)

   • TMDB API キーを追加します: TMDB_API_KEY=your_api_key_here

4. プロジェクトを構築する

   npm run build

5. サーバーを起動する

   npm start

Claudeデスクトップのセットアップ

1. クロードデスクトップを開く

2. 設定 > 開発タブへ移動

3. 「設定の編集」をクリックして設定ファイルを開きます

4. 設定に以下を追加します。

5. Claudeデスクトップを再起動します

使用例

静的リソースの使用

• 「TMDBとは何ですか？」

• 「今話題の映画を見せて」

リソーステンプレートの使用

• 「ID 550 の映画の詳細を取得する」（ファイト・クラブ）

• 「ID 155の映画について教えてください」（ダークナイト）

プロンプトの使用

• 「インセプションの詳細なレビューを書いて、9/10の評価をつけて」

• 「思索的な気分に浸りたいときにおすすめのSF映画」

ツールの使用

• 「宇宙探査に関する映画を検索」

• 「今流行の映画は何ですか？」

• 「マトリックスに似た映画を探す」

発達

プロジェクト構造

テスト

開発中にサーバーをテストするには、MCP Inspector を使用します。

ライセンス

マサチューセッツ工科大学

謝辞

• 映画データベース（TMDB）

• モデルコンテキストプロトコル