mcp-server-tmdb

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ファイルをご覧ください。

貢献

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