TMDB MCP サーバー

この MCP サーバーは、The Movie Database (TMDB) API と統合して、映画情報、検索機能、推奨事項を提供します。

前提条件

TMDB MCP サーバーをインストールして実行する前に、次の前提条件がインストールされ、構成されていることを確認してください。

必要なソフトウェア

• Node.js

  • バージョン18.0.0以上

  • Node.js公式サイトからダウンロード

  • インストールの確認: node --version

• npm (ノード パッケージ マネージャー)

  • バージョン 8.0.0 以上 (Node.js が付属)

  • インストールの確認: npm --version

• タイプスクリプト

  • プロジェクトの依存関係としてインストールされます

  • グローバルにインストールできます: npm install -g typescript

  • インストールの確認: tsc --version

必要なアカウントとAPIキー

• TMDBアカウント

  • TMDBの無料アカウント

  • TMDBダッシュボードからのAPIキー

  • APIアクセスはTMDBによる承認が必要です

• クロードデスクトップアプリケーション

  • 最新バージョンがインストールされています

  • 設定ファイルの変更権限

システム要件

• オペレーティングシステム

  • macOS（10.15以降）

  • Linux（最新ディストリビューション）

• ハードウェア要件

  • 最低4GBのRAM

  • 1GBの空きディスク容量

  • 安定したインターネット接続

開発環境

最高の開発エクスペリエンスを得るには、次のことをお勧めします。

• TypeScript をサポートするコード エディター (例: VS Code)

• ターミナルアクセス

• Git（バージョン管理用）

特徴

ツール

• 検索_映画

  • タイトルやキーワードで映画を検索する

  • 入力: query (文字列): 検索クエリ

  • 返されるもの: タイトル、公開年、ID、評価、概要を含む映画のリスト

  • 例: 宇宙探査に関する映画を検索する

• get_recommendations

  • 映画IDに基づいて映画のおすすめを取得する

  • 入力: movieId (文字列): TMDB 映画 ID

  • リターンズ：おすすめ映画トップ5と詳細

  • 例: 映画 ID 550 (ファイト・クラブ) に基づいて推奨事項を取得する

• トレンドを取得

  • 指定した期間のトレンド映画を取得する

  • 入力: timeWindow (文字列): 「day」または「week」のいずれか

  • リターンズ：注目の映画トップ10とその詳細

  • 例: 今日のトレンド映画を入手する

リソース

サーバーは、TMDB 映画情報へのアクセスを提供します。

• 映画( tmdb:///movie/<movie_id> )

  • 映画の包括的な詳細情報:

    • タイトルと発売日

    • 評価と概要

    • ジャンル

    • ポスターURL

    • キャスト情報（上位5人の俳優）

    • 監督

    • 厳選されたレビュー

  • すべてのデータはJSON形式で返されます

はじめる

1. TMDB API キーを取得します。

   • TMDBに登録する

   • アカウント設定に移動

   • APIセクションに移動する

   • 開発者用のAPIキーをリクエストする

2. プロジェクトのクローンを作成してセットアップします。

   git clone [repository-url] cd mcp-server-tmdb npm install

3. サーバーを構築します。

   npm run build

4. 環境変数を設定します。

   export TMDB_API_KEY=your_api_key_here

Claude Desktopでの使用

このサーバーを Claude Desktop と統合するには、アプリのサーバー構成ファイル ( ~/Library/Application Support/Claude/config.jsonにある) に次のコードを追加します。

/full/path/toプロジェクト ディレクトリへの実際のパスに置き換えます。

Smithery経由でインストール

Smithery経由で Claude Desktop 用の TMDB サーバーを自動的にインストールするには:

使用例

Claude Desktop を使用してサーバーを実行すると、次のようなコマンドを使用できます。

1. 映画を検索:

   "Search for movies about artificial intelligence"

2. トレンドの映画を入手:

   "What are the trending movies today?" "Show me this week's trending movies"

3. 映画のおすすめを入手:

   "Get movie recommendations based on movie ID 550"

4. 映画の詳細を見る:

   "Tell me about the movie with ID 550"

エラー処理

サーバーには、次の包括的なエラー処理が含まれています。

• 無効なAPIキー

• ネットワークエラー

• 無効な映画ID

• 不正なリクエスト

エラー メッセージは、Claude Desktop を通じてユーザーフレンドリーな形式で返されます。

発達

開発中の変更を監視するには:

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。詳細はLICENSEファイルをご覧ください。

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。