Imdb MCP Server

🚀 IMDb MCP サーバー使用ガイド

IMDb MCP サーバーは、IMDb のデータを効率的に取得するためのツールです。このガイドでは、サーバーのインストール、設定、使用方法について説明します。

🚀 クイックスタート

IMDb MCP サーバーを使用するには、まずサーバーをインストールし、環境変数を設定し、必要な設定ファイルを編集する必要があります。以下に手順を説明します。

📦 インストール

1. MCP CLI を使用してサーバーを起動する

# 直接起動
python imdb_server.py

# または MCP CLI を使用する
mcp run imdb_server.py

# Docker を使用する場合、コンテナとともにサーバーが自動的に起動します
docker run -d -p 8000:8000 -e RAPID_API_KEY_IMDB=your_api_key_here --name imdb_server imdb_server

2. 環境変数を設定する

ターミナルで以下の環境変数を設定します。

# IMDb API キーを設定する
export RAPID_API_KEY_IMDB=your_api_key_here

# Docker を使用する場合は、コンテナを起動する際にパラメータで渡すことができます
docker run -d -p 8000:8000 -e RAPID_API_KEY_IMDB=your_api_key_here --name imdb_server imdb_server

3. claude_desktop_config.json を設定する

以下の設定を claude_desktop_config.json ファイルに追加します。

{
  "mcpServers": {
    "imdb_server": {
      "command": "/path/to/your/python",
      "args": [
        "/path/to/imdb_server.py"
      ],
      "env": {
        "RAPID_API_KEY_IMDB": "your_api_key_here"
      }
    }
  }
}

💻 使用例

1. データ検索ツール

すべてのデータ検索ツールはページング機能をサポートしており、一度に最大 5 件の結果を返します。

例：映画ランキング（Top 250）を取得する

# 上位 5 位を取得する
get_top_250_movies()

# 6 位から 10 位を取得する
get_top_250_movies(start=5)

2. ページングシステム

リクエスト例：

get_top_250_movies(start=5) # 6 - 10 件目を返す

レスポンス例：

{
  "movies": [
    {
      "id": "tt0012345",
      "title": "映画名称",
      "year": 2023,
      "rating": 9.5,
      "description": "映画の概要"
    },
    ...
  ],
  "metadata": {
    "totalCount": 250,
    "hasMore": true,
    "nextStart": 10
  }
}

🔧 技術詳細

実装フレームワーク

• IMDb API：RapidAPI を介して呼び出されます
• MCP：API インターフェースに使用されます
• Requests：API 通信に使用されます
• FastMCP：サーバー実装フレームワーク
• カスタムキャッシュシステム：メモリキャッシュ
• ページングシステム：一度に返される結果を 5 件に制限します

キャッシュメカニズム

• デフォルトのキャッシュ設定：

  response_cache = ResponseCache(expiry_seconds=120, max_size=50)
  

• 機能特性：
  • レスポンスをメモリにキャッシュします
  • 有効期限を設定します（デフォルト：10 分）
  • 最大キャッシュサイズを設定します（デフォルト：100 個のキー）
  • 定期的に期限切れのエントリをクリーンアップします

📄 注意事項

⚠️ 重要提示

• API 呼び出し回数は RapidAPI のプランによって制限されます。
• 一部の詳細情報は個別にリクエストする必要があります。
• ページング機能は手動で実装する必要があります。
• キャッシュメカニズムはパフォーマンスを向上させますが、キャッシュの無効化を処理する必要があります。

付録

依存関係のインストール

pip install requests mcp

サンプルコード

from imdb_mcp import IMDBClient

client = IMDBClient('your_api_key_here')
movies = client.get_top_250_movies(start=0)
print(movies)

以上の手順に従うことで、IMDb MCP サーバーを正常に設定して使用することができます。