Skip to main content
Glama
Adarsh2001-dot

IMDB MCP Server

IMDB MCP Server

クラウド上で実行できるJSON-RPCサービスで、IMDBデータへのアクセスを提供します。LLMがMCP(Model Context Protocol)を介して利用できるように設計されています。

動作の仕組み

  1. LLM設定: MCPサーバーのURLをLLMの設定に追加します

  2. ディスカバリ: LLMがサーバーのURLに問い合わせて、利用可能なツールを把握します

  3. クエリ: LLMがJSON-RPCリクエストを送信してIMDBデータを取得します

  4. レスポンス: サーバーが構造化されたデータを返し、LLMがそれを解釈してユーザーに説明します

Related MCP server: moviefinder-mcp

エンドポイント

エンドポイント

メソッド

説明

/

GET

HTMLドキュメント(人間が読める形式)

/info

GET

サービス情報(JSON)

/jsonrpc

POST

JSON-RPC 2.0エンドポイント

/mcp

POST

LLMツール呼び出し用のMCPプロトコルエンドポイント

/health

GET

クラウドデプロイ用のヘルスチェック

利用可能なツール

ツール

説明

パラメータ

search_movies

タイトルで映画を検索

query, limit

get_movie_details

映画の詳細情報を取得

movie_id

search_people

俳優・監督を検索

query, limit

get_person_details

人物情報・出演作品一覧を取得

person_id

get_top_250_movies

IMDB Top 250を取得

limit

get_movie_cast

映画のキャストを取得

movie_id, limit

JSON-RPCの使い方

/jsonrpc にPOSTリクエストを送信します:

{
    "jsonrpc": "2.0",
    "method": "search_movies",
    "params": {"query": "The Matrix", "limit": 5},
    "id": 1
}

レスポンス:

{
    "jsonrpc": "2.0",
    "result": [
        {"id": "0133093", "title": "The Matrix", "year": 1999},
        {"id": "0234215", "title": "The Matrix Reloaded", "year": 2003}
    ],
    "id": 1
}

LLM MCP設定

LLMのMCPサーバー設定に追加します:

{
    "mcpServers": {
        "imdb": {
            "url": "https://your-deployed-url.com/mcp",
            "transport": "http"
        }
    }
}

ローカル開発

ローカルで実行する

pip install -r requirements.txt
python app.py

サーバーは http://localhost:8080 で起動します。

Dockerで実行する

docker build -t imdb-mcp .
docker run -p 8080:8080 imdb-mcp

クラウドデプロイ

Cloud Foundry

cf push

manifest.yaml の設定を使用します。

SAP BTP (Cloud Foundry)

# Build MTA archive
mbt build

# Deploy
cf deploy mta_archives/imdb-mcp-server_1.0.0.mtar

mta.yaml の設定を使用します。

Heroku

heroku create imdb-mcp-server
git push heroku main

Procfile と runtime.txt を使用します。

Docker(任意のクラウド)

# Build
docker build -t imdb-mcp .

# Run
docker run -p 8080:8080 imdb-mcp

# Push to registry
docker tag imdb-mcp your-registry/imdb-mcp:latest
docker push your-registry/imdb-mcp:latest

Google Cloud Run

gcloud run deploy imdb-mcp \
    --source . \
    --platform managed \
    --allow-unauthenticated

AWS App Runner / ECS

任意のAWSコンテナサービスでDockerfileを使用します。

プロジェクト構成

imdb-mcp/
├── app.py              # FastAPI JSON-RPC server
├── imdb_backend.py     # Cinemagoer wrapper
├── server.py           # FastMCP server (for local MCP)
├── requirements.txt    # Python dependencies
├── pyproject.toml      # Project metadata
├── Dockerfile          # Container image
├── Procfile            # Heroku/PaaS process file
├── runtime.txt         # Python version
├── manifest.yaml       # Cloud Foundry manifest
├── mta.yaml            # SAP BTP MTA descriptor
├── .dockerignore       # Docker ignore patterns
└── .cfignore           # Cloud Foundry ignore patterns

環境変数

変数

デフォルト

説明

PORT

8080

サーバーポート

注意事項

  • CinemagoerはWebスクレイピングを介してIMDBに問い合わせるため、APIベースのソリューションよりもレスポンスが遅くなる場合があります

  • IMDBの利用規約に基づき、非営利目的のみで使用できます

  • APIキーは不要です

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Provides access to IMDB movie and person data, including searches, cast details, and top-rated lists through the Model Context Protocol. It enables LLMs to fetch structured cinematic metadata and filmographies using the Cinemagoer backend.
    1
    -
  • F
    license
    A
    quality
    D
    maintenance
    An MCP server that wraps The Movie Database (TMDB) API, enabling search for movies and TV shows, retrieval of movie details, recommendations, similar movies, trending content, streaming providers, and movie discovery.
    8
    -
  • A
    license
    A
    quality
    C
    maintenance
    MCP server for the OMDb API - search movies, series, and episodes from any MCP-compatible client.
    5
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    A robust MCP server that wraps The Movie Database API, enabling LLMs to search movies, get details, popular movies, and recommendations.
    -