MCP TMDB

🚀 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 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 とは何ですか？"
"現在人気のある映画を表示して"

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

# リソーステンプレートの使用例
"ID が 550 の映画（Fight Club）の情報を取得して"
"ID 155 の映画（The Dark Knight）について教えて"

プロンプトの使用

# プロンプトの使用例
"『盗夢空間』についての詳細なレビューを 9/10 の評価で書いて"
"考える気分に合ったSF映画をいくつか推薦して"

ツールの使用

# ツールの使用例
"宇宙探査に関する映画を検索して"
"今日の人気映画は何ですか？"
"『マトリックス』に類似する映画を検索して"

📚 ドキュメント

プロジェクト構造

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 (MCP)