TMDB MCP Server

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. Settings > Developer タブに移動します
3. "Edit Config" をクリックして設定ファイルを開きます
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）

プロンプトを使用する

• 「Inception の詳細なレビューを、10 点満点中 9 点の評価で書いてください」
• 「思索的な気分のときにおすすめの SF 映画を教えてください」

ツールを使用する

• 「宇宙探査に関する映画を検索してください」
• 「今日のトレンド映画は何ですか？」
• 「The Matrix に似た映画を探してください」

開発

プロジェクト構成

tmdb-mcp/
├── src/
│   ├── index.ts                # Main server file
│   ├── config.ts               # Configuration and API keys
│   ├── handlers.ts             # Request handlers
│   ├── resources.ts            # Static resources
│   ├── resource-templates.ts   # Dynamic resource templates
│   ├── prompts.ts              # Prompt definitions
│   ├── tools.ts                # Tool implementations
│   └── tmdb-api.ts             # TMDB API wrapper
├── package.json
├── tsconfig.json
└── README.md

テスト

開発中に MCP Inspector を使用してサーバーをテストします：

npx @modelcontextprotocol/inspector node build/index.js

ライセンス

MIT

謝辞

• The Movie Database (TMDB)
• Model Context Protocol