TMDB

🚀 TMDB MCP サーバー

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

🚀 クイックスタート

TMDB MCP サーバーを使うことで、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
   

💻 使用例

静的リソースの使用

• “TMDB とは何ですか？”
• “現在人気のある映画を表示してください”

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

• “ID が 550 の映画の詳細を取得してください”（Fight Club）
• “ID 155 の映画に関する情報を教えてください”（The Dark Knight）

プロンプトの使用

• “《盗夢空間》の詳細なレビューを 9/10 の評価で書いてください”
• “考える気分に合ったSF映画を推薦してください”

ツールの使用

• “宇宙探索に関する映画を検索してください”
• “今日の人気映画はどれですか？”
• “《マトリックス》に類似した映画を検索してください”

📚 ドキュメント

Claude Desktop 用の設定

1. Claude Desktop を開きます。
2. 設定 > 開発者オプションタブに移動します。
3. “編集設定” をクリックして、設定ファイルを開きます。
4. あなたの設定に以下の内容を追加します。

{
  "mcpServers": {
    "tmdb-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/your/tmdb-mcp/build/index.js"]
    }
  }
}

5. Claude Desktop を再起動します。

開発

プロジェクト構造

tmdb-mcp/
├── src/
│   ├── index.ts                # メインサーバーファイル
│   ├── config.ts               # 設定と API キー
│   ├── handlers.ts             # リクエストハンドラー
│   ├── resources.ts            # 静的リソース
│   ├── resource-templates.ts   # 動的リソーステンプレート
│   ├── prompts.ts              # プロンプト定義
│   ├── tools.ts                # ツールの実装
│   └── tmdb-api.ts             # TMDB API ラッパー
├── package.json
├── tsconfig.json
└── README.md

テスト

開発中は、MCP インスペクターを使ってサーバーをテストします。

npx @modelcontextprotocol/inspector node build/index.js

📄 ライセンス

MIT

謝辞

• The Movie Database (TMDB)
• Model Context Protocol