SceneF — California + Hawaii Movie Showtimes

SceneF — カリフォルニア、フロリダ、ハワイの映画上映時間（MCP サーバー）

映画を愛する人々と、そのアシスタントのために、映画好きが作りました。

SceneF は、今も映画文化が息づく数少ない都市のひとつ、サンフランシスコで始まりました。 1920年代から続く近所の単スクリーン映画館、毎晩変わる名画座の上映スケジュール、 35mmや70mmのフィルム上映、深夜映画、そしてもちろん、 シネマコンプレックスもあります。現在は、ロサンゼルスからサクラメントまで、 サンディエゴからマウイまで、マイアミからペンサコーラまで、カリフォルニア、フロリダ、ハワイの56の地域別ボードを運営しています。 各ボードは、映画館の上映スケジュールとサードパーティの上映時間データサービスをまとめ、 情報源の信頼度と鮮度も提供するため、呼び出し元は上映情報の根拠を確認できます。

リモート MCP サーバーはストリーミング可能な HTTP に対応し、API キー不要、読み取り専用です。このリポジトリには、同じ10個のツールを実行するローカルの stdio サーバーもあります。

scenef_resolve_board 以外のすべてのツールでは region が必要です — "sf"、"la-central"、"oahu"、 "sacramento"、…です。省略するとデフォルトのボード（sf）が使われ、現在地から 推測されることはありません。場所の名前から検索するには scenef_resolve_board を、 現在のボード一覧を取得するには、region を指定せずに scenef_now を使ってください。 時刻は各映画館の現地時刻です。ハワイは太平洋標準時より2〜3時間遅く、夏時間はなく、 各ボードはデータとともにタイムゾーンを報告します。

https://scenef.com/mcp

接続

Claude Code

claude mcp add --transport http scenef https://scenef.com/mcp

Claude Desktop / 任意の MCP クライアント（.mcp.json / クライアント設定）

{
  "mcpServers": {
    "scenef": {
      "type": "http",
      "url": "https://scenef.com/mcp"
    }
  }
}

公式 MCP レジストリにも com.scenef/showtimes として掲載されています。

またはローカルで実行

このリポジトリはローカルの MCP サーバーでもあります。Node、stdio、プロキシは不要です。プロトコルを 直接実装し、SceneF の公開 REST API から同じボードを読み込みます。 同じ10個の公開ツールと一致ルールを、どちらの トランスポートでも利用できます。REST キャッシュにより、2つの応答が一時的に異なる場合があります。

npx -y github:speedwarnsf/scenef-mcp

Claude Desktop / 任意の stdio クライアント

{
  "mcpServers": {
    "scenef": {
      "command": "npx",
      "args": ["-y", "github:speedwarnsf/scenef-mcp"]
    }
  }
}

クローンしたリポジトリから、または Docker で

npm install && npm start

docker build -t scenef-mcp . && docker run --rm -i scenef-mcp

API キーもアカウントも設定も不要です。送信する User-Agent: scenef-mcp-local/1.1 は、GET 以外のリクエストを発行せず、書き込み経路も 一切ありません。

npm test はまず、保存済みのホスト側スキーマ契約とフィクスチャフィードを使ったオフライン回帰テストを実行します。test/contract.js は、ライブボードに対して10個すべてのツールを呼び出し、すべてのペイロードがサーバーの 出力スキーマに適合することを検証します。また、test/parity.js は、このサーバーのツール定義とホストされたエンドポイントの定義を比較します。ローカルでプレビューするには、 SCENEF_BASE_URL=http://localhost:3017 と SCENEF_MCP_URL=http://localhost:3017/mcp の両方を設定してください。オフライン実行が成功しても、外部スキーマが 更新されたことを意味するわけではありません。プレビューのデータセットが限られている場合は、 地域別プローブ用に SCENEF_PARITY_REGION=oahu（または、データがある別の非デフォルトボード）を設定してください。 デフォルトは la-central です。

ツール

ツール	回答内容
scenef_whats_playing	今夜／明日／週末／指定日の映画をランキング形式で表示します。期間に今夜が含まれる場合は、今夜の注目情報から始まり、残席数の実測値、最終上映日、唯一の35mm／70mmプリント、告知済みの割引、ライブイベントなど、根拠を添えた希少情報を紹介します
scenef_search_showtimes	1本の映画または1つの映画館の上映時間を、日付と厳密な時間フィルター付きで表示します
scenef_theater_info	1つの映画館の住所、近隣エリア、常設割引、今後の上映予定を表示します
scenef_film_details	公開年、上映時間、レーティング、出演者、予告編、最も近い今後の上映時間を表示します
scenef_plan_movie_night	制約（時間帯、ジャンル、上映形式、映画館）を指定して、鑑賞プランを作成します
scenef_discounts	映画館全体のお得な割引日を表示します
scenef_coming_soon	次に公開される作品を表示します
scenef_resolve_board	都市、郵便番号、近隣エリア、別名から、対象地域をカバーする掲示板を特定します。特定できない場合は、どのような理由で該当しないのかを示して回答します
scenef_now	現時点のスナップショットを表示します。今すぐ鑑賞できる作品を確認できます
scenef_accuracy	独自の検証記録を表示します。実行したチェック、失敗したチェック、到達できなかったチェックを確認できます

掲示板を参照するツールは、一度に1つの地域掲示板について回答します。region を指定して掲示板を選択してください。返されたチケット、カレンダー、映画のURLは、地域別パスや?region=のヒントも含め、すべて正確に保持してください。無効な厳密な日付／時間フィルターに対しては、フィルターを適用しないまま成功とするのではなく、拒否と警告を返します。広告や有料のランキングはありません。名画座もシネコンと同等に扱います。近隣の映画館で唯一上映される35mmプリントは、まさにこのサーバーが見つけ出すために存在するものです。その映画館がリッチモンドにあっても、ヒロにあっても同じです。

scenef_whats_playingは簡潔モードでは合計showtime_countと、showtimes内の次回上映のみを返します。詳細モードでは上映時間の行が追加され、回答あたり約200件になります。scenef_film_detailsと scenef_search_showtimesは、簡潔モードでは最も近い上映時間を40件、詳細モードでは最大200件返します。showtime_countは常に合計件数を示し、 showtimes_completeは配列に全件が含まれているかどうかを示します。残りの上映時間を確認するには、日付または映画館で絞り込んでください。

信頼できる理由

• 上映時間は、劇場のスケジュールとサードパーティの上映時間データサービスから取得しています。チェーン系劇場の大半や一部の独立系劇場を含む多くの上映時間は、劇場自身ではなく、そのサービスから取得しています。これらには source_tier: licensed-feed というラベルが付いており、サイト上で最も信頼性の低い情報です。返されるすべての上映情報には、簡潔モードと詳細モードの両方で confidence、source_tier、sources、verified_at が含まれます。
• data_as_of はデータセットの公開時刻です。verified_at と freshness は上映情報のソース証拠を示します。新しいデータセットに古い行が残っている場合があります。鮮度が示すのは最新性であり、正確性ではありません。古い情報や保持された上映情報を利用する前に、劇場に確認してください。
• 検証記録は公開されています。不合格だったチェックも含まれます： scenef.com/api/accuracy。

ローカルの scenef_now.sources サマリーでは、ホスト型サーバーと同じ方法で、劇場の健全性を劇場ごとに集計し、上映情報が古くなっている可能性のある劇場を、ホスト型サーバーと同じ表現で示します。この健全性は各上映情報の freshness.source_status から読み取るため、上映一覧に情報がない劇場はローカルでは確認できず、集計にも含まれません。その分、ホスト型の件数のほうが多くなることがあります。このことは、ペイロードの basis と、文章の末尾にある Data: 行に記載されています。上記の行、以下のエッジキャッシュに関する注記、入力検証エラー（MCP SDK では表現が異なりますが、制限は同じです）を除き、すべての回答文はホスト型サーバーと一語一句同じです。両方のトランスポートで、上映ごとの鮮度は正規 REST フィードから取得します。ローカルサーバーはフィードの retained と source_status の値をそのまま保持し、ホスト型サーバーと同様に、呼び出し時点の verified_at を基準に age_hours と status を算出します。

REST の各エンドポイントはエッジキャッシュ経由で提供されます。キャッシュの有効期限が切れると、更新中は、次のリクエストに期限切れのコピーが返されます。ホスト型サーバーは最新のデータセットを読み込むため、このようなコピーを参照することはありません。エッジが古いコピーを返した場合、ローカルサーバーは再度リクエストします（約3秒間に3回再試行します）。それでもエッジが古いコピーを返し続ける場合、そのコピーをもとに回答を作成し、フッターの後にその旨を1行で記載します。この場合、data_as_of はそのコピーの時刻になります。

通常の HTTP を使いたい場合

同じデータを REST 形式でも提供しています。全仕様については scenef.com/agents をご覧ください： /api/listings · /ask · OpenAPI · llms.txt

お問い合わせ

[email protected] · scenef.com