AMC Theatres向けの包括的な映画予約体験を提供するModel Context Protocol (MCP)サーバーです。このサーバーにより、会話型AIアシスタントは、シンプルなAPIインターフェースを通じて、ユーザーが映画の発見、上映時間の検索、座席の予約、支払い処理を行うのを支援できます。
映画検索: 現在上映中の映画を閲覧し、パーソナライズされたおすすめを取得
上映時間検索: 場所、日付、映画で利用可能な上映時間を検索
座席選択: インタラクティブな座席マップを表示し、空き状況を確認
予約管理: リアルタイムの空き状況チェックで座席を予約
支払い処理: 確認レシート付きのモック支払いトランザクションを処理
複数ロケーション対応: 複数のAMCシアターのロケーションを横断して検索
Related MCP server: Travel Amadeus MCP Server
Python 3.8+
Docker（オプション、コンテナ化デプロイ用）
リポジトリをクローン:
git clone <repository-url>
cd amc-mcp依存関係をインストール:
pip install -r requirements.txtパッケージをインストール:
pip install -e .サーバーを実行:
python -m amc_mcp.fastmcp_serverDocker Composeでビルドして実行:
docker-compose up --buildまたは手動でビルドして実行:
docker build -t amc-mcp .
docker run -it amc-mcp指定された場所で現在上映中の映画のリストを返します。
入力:
{
"location": "Boston, MA"
}出力:
{
"location": "Boston, MA",
"movies": [
{
"movie_id": "mv001",
"title": "Dune: Part Two",
"rating": "PG-13",
"duration": 166,
"genre": "Sci-Fi/Action",
"description": "Paul Atreides unites with Chani..."
}
]
}気分、ジャンル、または好みに基づいて映画を提案します。
入力:
{
"genre": "action",
"mood": "exciting"
}出力:
{
"criteria": {"genre": "action", "mood": "exciting"},
"recommendations": [...]
}特定の映画と場所の利用可能な上映時間を取得します。
入力:
{
"movie_id": "mv001",
"date": "2025-10-28",
"location": "Boston, MA"
}出力:
{
"movie": {"id": "mv001", "title": "Dune: Part Two"},
"date": "2025-10-28",
"location": "Boston, MA",
"showtimes": [
{
"showtime_id": "st001",
"theater_name": "AMC Boston Common 19",
"theater_address": "175 Tremont Street",
"time": "14:00",
"format": "IMAX",
"price": 18.50
}
]
}特定の上映時間の利用可能な座席と予約済みの座席を表示します。
入力:
{
"showtime_id": "st001"
}出力:
{
"showtime_id": "st001",
"movie": "Dune: Part Two",
"theater": "AMC Boston Common 19",
"date": "2025-10-28",
"time": "14:00",
"seat_map": [
{
"seat_number": "A5",
"row": "A",
"column": 5,
"is_available": true,
"price_tier": "Standard",
"price": 18.50
}
]
}選択した座席をユーザー用に予約します。
入力:
{
"showtime_id": "st001",
"seats": ["A5", "A6"],
"user_id": "user123"
}出力:
{
"booking_id": "booking-uuid",
"status": "pending",
"movie": "Dune: Part Two",
"theater": "AMC Boston Common 19",
"date": "2025-10-28",
"time": "14:00",
"seats": ["A5", "A6"],
"total_price": 37.00
}シミュレートされた支払いトランザクションを処理します。
入力:
{
"booking_id": "booking-uuid",
"payment_method": "card",
"amount": 37.00
}出力:
{
"payment_id": "payment-uuid",
"payment_status": "success",
"booking_id": "booking-uuid",
"receipt_url": "https://amc.com/receipts/payment-uuid",
"confirmation": {
"movie": "Dune: Part Two",
"theater": "AMC Boston Common 19",
"date": "2025-10-28",
"time": "14:00",
"seats": ["A5", "A6"],
"total_paid": 37.00
}
}典型的な映画予約の会話は次のように進みます:
ユーザー: 「今夜、近くでアクション映画を探して。」
サーバー呼び出し: get_now_showing + get_recommendations
返り値: 上映時間付きのアクション映画のリスト
ユーザー: 「Dune: Part Twoの午後8時の座席を2つ予約して。」
サーバー呼び出し: get_showtimes → get_seat_map → book_seats
返り値: 座席選択と予約確認
ユーザー: 「カードで支払う。」
サーバー呼び出し: process_payment
返り値: デジタルレシート付きの支払い確認
amc-mcp/
├── src/
│ └── amc_mcp/
│ ├── __init__.py
│ └── server.py # Main MCP server implementation
├── data/
│ ├── movies.json # Movie catalog
│ ├── theaters.json # Theater locations
│ ├── showtimes.json # Showtime schedules
│ └── seats.json # Seat maps by showtime
├── config/
│ └── nginx.conf # Web server configuration
├── Dockerfile # Container configuration
├── docker-compose.yml # Multi-service orchestration
├── requirements.txt # Python dependencies
├── pyproject.toml # Package configuration
└── README.md # This file{
"movie_id": str,
"title": str,
"rating": str, # PG, PG-13, R, etc.
"duration": int, # Minutes
"genre": str,
"description": str,
"poster_url": str
}{
"theater_id": str,
"name": str,
"address": str,
"city": str,
"state": str,
"zip_code": str
}{
"showtime_id": str,
"movie_id": str,
"theater_id": str,
"date": str, # YYYY-MM-DD
"time": str, # HH:MM
"format": str, # Standard, IMAX, 3D, Dolby
"price": float
}data/movies.json を編集して新しい映画を追加:
{
"movie_id": "mv011",
"title": "New Movie Title",
"rating": "PG-13",
"duration": 120,
"genre": "Action",
"description": "Description of the movie...",
"poster_url": "https://example.com/poster.jpg"
}data/theaters.json を編集:
{
"theater_id": "th011",
"name": "AMC New Location 15",
"address": "123 Main Street",
"city": "New City",
"state": "NY",
"zip_code": "12345"
}data/showtimes.json と data/seats.json を編集して、新しい上映時間と対応する座席マップを追加します。
MCPインスペクターを使用するか、MCP互換のクライアントに接続して、個々のツールをテストできます。
Claude Desktopを設定してMCPサーバーに接続
自然言語を使用して予約フローをテスト
例: 「今夜ボストンで上映中のSF映画を探して」
PYTHONPATH: 適切なモジュール解決のために /app/src に設定
PYTHONUNBUFFERED: リアルタイムログのために 1 に設定
MCP_LOG_LEVEL: ログレベルを設定（DEBUG、INFO、WARNING、ERROR）
サーバーは軽量なPython 3.11コンテナで実行され、以下を備えています:
セキュリティのための非rootユーザー
監視のためのヘルスチェック
データ永続化のためのボリュームマウント
ネットワーク分離
これはデモ目的のモック実装です。本番環境では:
支払い処理: 実際の支払いゲートウェイ（Stripe、PayPal）と統合
認証: ユーザー認証と認可を追加
データ検証: 包括的な入力検証を実装
レート制限: APIレート制限を追加
暗号化: HTTPSを使用し、機密データを暗号化
データベース: JSONファイルを実際のデータベースに置き換え
ログ: 構造化ログと監視を実装
実際のAMC API統合: 実際のAMC Theatres APIに接続
ユーザーアカウント: 永続的なユーザープロファイルと予約履歴
グループ予約: 複数のユーザーが一緒に予約するためのサポート
ロイヤルティプログラム: AMC Stubs統合
モバイルチケット: モバイル入場用のQRコードを生成
座席レコメンデーション: AIによる最適な座席提案
価格アラート: 割引やプロモーションをユーザーに通知
ソーシャル機能: 友人と映画の予定を共有
アクセシビリティ: ADA準拠の座席選択
多言語対応: 国際言語サポート
リポジトリをフォーク
フィーチャーブランチを作成: git checkout -b feature/new-feature
変更を加えてテストを追加
変更をコミット: git commit -am 'Add new feature'
ブランチにプッシュ: git push origin feature/new-feature
プルリクエストを送信
このプロジェクトはMITライセンスの下でライセンスされています。詳細はLICENSEファイルを参照してください。
質問、問題、機能リクエストについては:
GitHubリポジトリでイシューを作成
一般的な解決策についてはドキュメントを確認
例の会話フローを参照
楽しい映画予約を！ 🍿🎬
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Discover and book businesses via AI agents.
An AI concierge that turns static forms into adaptive AI conversations. From any MCP client.
AI marketplace — flights, tours, activities, transport & more via MCP. No auth required.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ho-ju/amc-mcp-hoju'
If you have feedback or need assistance with the MCP directory API, please join our Discord server