IMDB MCP Server
IMDB MCP Server
クラウド上で実行できるJSON-RPCサービスで、IMDBデータへのアクセスを提供します。LLMがMCP(Model Context Protocol)を介して利用できるように設計されています。
動作の仕組み
LLM設定: MCPサーバーのURLをLLMの設定に追加します
ディスカバリ: LLMがサーバーのURLに問い合わせて、利用可能なツールを把握します
クエリ: LLMがJSON-RPCリクエストを送信してIMDBデータを取得します
レスポンス: サーバーが構造化されたデータを返し、LLMがそれを解釈してユーザーに説明します
Related MCP server: moviefinder-mcp
エンドポイント
エンドポイント | メソッド | 説明 |
| GET | HTMLドキュメント(人間が読める形式) |
| GET | サービス情報(JSON) |
| POST | JSON-RPC 2.0エンドポイント |
| POST | LLMツール呼び出し用のMCPプロトコルエンドポイント |
| GET | クラウドデプロイ用のヘルスチェック |
利用可能なツール
ツール | 説明 | パラメータ |
| タイトルで映画を検索 |
|
| 映画の詳細情報を取得 |
|
| 俳優・監督を検索 |
|
| 人物情報・出演作品一覧を取得 |
|
| IMDB Top 250を取得 |
|
| 映画のキャストを取得 |
|
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 pushmanifest.yaml の設定を使用します。
SAP BTP (Cloud Foundry)
# Build MTA archive
mbt build
# Deploy
cf deploy mta_archives/imdb-mcp-server_1.0.0.mtarmta.yaml の設定を使用します。
Heroku
heroku create imdb-mcp-server
git push heroku mainProcfile と 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:latestGoogle Cloud Run
gcloud run deploy imdb-mcp \
--source . \
--platform managed \
--allow-unauthenticatedAWS 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環境変数
変数 | デフォルト | 説明 |
| 8080 | サーバーポート |
注意事項
CinemagoerはWebスクレイピングを介してIMDBに問い合わせるため、APIベースのソリューションよりもレスポンスが遅くなる場合があります
IMDBの利用規約に基づき、非営利目的のみで使用できます
APIキーは不要です
This server cannot be deployed
Maintenance
Related MCP Connectors
OMDb MCP — IMDB-derived movie / TV / episode data (BYO key)
Movie and series ranking as MCP tools: top titles, search, lookup by IMDb id. Free, no key.
Movies MCP — wraps iTunes Search API (movies, free, no auth) and TVmaze API (TV shows, free, no…
MCP server for Clipkit — gives AI agents a video toolbox via the Clipkit schema.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides 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-
- FlicenseAqualityDmaintenanceAn 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-
- AlicenseAqualityCmaintenanceMCP server for the OMDb API - search movies, series, and episodes from any MCP-compatible client.5MIT
- FlicenseNot gradedqualityDmaintenanceA robust MCP server that wraps The Movie Database API, enabling LLMs to search movies, get details, popular movies, and recommendations.-