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キー

インストール

このリポジトリをクローンする
git clone https://github.com/your-username/tmdb-mcp.git cd tmdb-mcp
依存関係をインストールする
npm install
TMDB APIキーを設定する
- プロジェクトルートに.envファイルを作成します (代替案: src/config.tsを直接編集します)
- TMDB API キーを追加します: TMDB_API_KEY=your_api_key_here
プロジェクトを構築する
npm run build
サーバーを起動する
npm start

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

クロードデスクトップを開く
設定 > 開発タブへ移動
「設定の編集」をクリックして設定ファイルを開きます
設定に以下を追加します。

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

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

使用例

静的リソースの使用

「TMDBとは何ですか？」
「今話題の映画を見せて」

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

「ID 550 の映画の詳細を取得する」（ファイト・クラブ）
「ID 155の映画について教えてください」（ダークナイト）

プロンプトの使用

「インセプションの詳細なレビューを書いて、9/10の評価をつけて」
「思索的な気分に浸りたいときにおすすめのSF映画」

ツールの使用

「宇宙探査に関する映画を検索」
「今流行の映画は何ですか？」
「マトリックスに似た映画を探す」

発達

プロジェクト構造

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

ライセンス

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

TMDB MCP Server

Integrations