tmdb-mcp-server

TMDB MCP サーバー

Model Context Protocol（MCP）サーバーです。The Movie Database（TMDB） API にアクセスできます。このサーバーを使うと、Claude などの MCP クライアントで映画、テレビ番組、人物を検索したり、詳細情報やおすすめを取得したりできます。

🌟 Official MCP Registryで公開されました

クイックスタート

npm を使ってすぐに始められます：

# Install globally
npm install -g tmdb-mcp-server

# Or use with npx (no installation needed)
npx tmdb-mcp-server

無料の TMDB API トークンを取得する：https://www.themoviedb.org/settings/api

機能

🎬 映画ツール

• search_movies - タイトルで映画を検索します
• get_movie_details - 特定の映画の詳細情報（予算、興行収入、上映時間、ジャンルなど）を取得します
• discover_movies - 高度なフィルター（ジャンル、言語、年の範囲、評価、並べ替え）を使って映画を探します
• get_recommendations - 特定の映画に基づいて映画をおすすめします
• get_movie_credits - 映画のキャストとスタッフの情報を取得します

📺 テレビ番組ツール

• search_tv_shows - 名前でテレビ番組を検索します
• get_tv_details - 特定のテレビ番組の詳細情報（シーズン、エピソード、ネットワークなど）を取得します
• discover_tv_shows - 高度なフィルター（ジャンル、言語、年、評価、並べ替え）を使ってテレビ番組を探します
• get_tv_recommendations - 特定のテレビ番組に基づいてテレビ番組をおすすめします
• get_tv_credits - テレビ番組のキャストとスタッフの情報を取得します

👥 人物ツール

• search_people - 俳優、監督、その他のエンターテインメント業界の専門家を検索します
• get_person_details - 人物の詳細な経歴情報を取得します

🔥 トレンド

• get_trending - 映画、テレビ番組、人物の日次または週次のトレンドを取得します

インストール

オプション 1：npm（推奨）

npm レジストリからインストールします：

npm install -g tmdb-mcp-server

これで完了です！ビルド手順は必要ありません。

オプション 2：ソースからインストール（開発向け）

前提条件：

• Node.js（v18 以降）
• TMDB API アクセストークン（TMDBから無料で取得できます）

手順：

1. リポジトリをクローンします：

git clone https://github.com/tcehjaava/tmdb-mcp-server.git
cd tmdb-mcp-server

2. 依存関係をインストールします：

npm install

3. TMDB アクセストークンを記載した .env ファイルを作成します：

cp .env.example .env
# Edit .env and add your TMDB_ACCESS_TOKEN

4. サーバーをビルドします：

npm run build

使い方

Claude Desktop で使用する

サーバーを Claude Desktop の設定に追加します：

MacOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%/Claude/claude_desktop_config.json

npm でインストールした場合：

{
  "mcpServers": {
    "tmdb": {
      "command": "npx",
      "args": ["-y", "tmdb-mcp-server"],
      "env": {
        "TMDB_ACCESS_TOKEN": "your_tmdb_access_token_here"
      }
    }
  }
}

ソースからインストールした場合：

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

その他の MCP クライアントで使用する

サーバーはデフォルトで stdio 上で動作するため、stdio トランスポートに対応するすべての MCP クライアントと互換性があります。

リモートデプロイ（HTTP モード）

リモートデプロイ向けに、Streamable HTTP トランスポートにも対応しています：

MCP_TRANSPORT=http PORT=3000 node build/index.js

Railway などのプラットフォームへの詳しいデプロイ手順については、TRANSPORT.mdを参照してください。

開発

ローカル開発

開発用にウォッチモードでサーバーを実行します：

npm run watch

デバッグ

デバッグには MCP Inspector を使用します：

npm run inspector

Inspector には、MCP ツールをテストおよびデバッグするためのウェブインターフェースが用意されています。

コードのフォーマット

Prettier でコードをフォーマットします：

npm run format

クエリの例

Claude で試せるクエリの例を紹介します：

• 「評価が 7 を超える、2020 年以降の日本の SF 映画を探して」
• 「今週、最もトレンドになっている映画は？」
• 「『マトリックス』をもとにおすすめを教えて」
• 「クリストファー・ノーランの映画を検索して」
• 「テレビ番組『ブレイキング・バッド』の詳細を見せて」
• 「評価の高い韓国ドラマを探して」

API レート制限

TMDB API の無料プランにはレート制限があります。

• 1 秒あたり 50 リクエスト
• 本番環境での使用では、キャッシュの実装を検討してください

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。大きな変更を行う場合は、まず issue を作成し、変更内容についてご相談ください。

ガイドラインについては、CONTRIBUTING.md をご覧ください。

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細は LICENSE ファイルをご覧ください。

謝辞

• Model Context Protocol SDK を使用して構築されています
• データ提供：The Movie Database (TMDB)
• 本製品は TMDB API を使用していますが、TMDB による承認または認証を受けていません

リンク

• MCP ドキュメント
• TMDB API ドキュメント
• Claude Desktop