Movie Reservation MCP

映画予約 GraphQL API 用の MCP ラッパー。

このリポジトリは、実装が golden-path/demo ベースラインから抽出される間、予約 MCP が 独自の issue トラッカー、CI、およびアーティファクトパイプラインを持てるようにするために 存在します。

実行

uv run movie-reservation-mcp

本番コンテナは UID 10001 で実行され、ポート 8091 で待ち受けます:

docker build --tag movie-reservation-mcp:local .
docker run --rm --network host movie-reservation-mcp:local

デモでは、MCP コンテナと予約 API コンテナが 1 つの ECS タスクネットワーク名前空間を 共有していることを前提としているため、デフォルトのダウンストリームアドレスは 127.0.0.1:3000 のままです。コンテナを個別に実行する場合は、ダウンストリーム URL を 上書きしてください。

デフォルト:

• MCP エンドポイント: http://127.0.0.1:8091/mcp

• ヘルスエンドポイント: http://127.0.0.1:8091/health

• ダウンストリーム GraphQL API: http://127.0.0.1:3000/graphql

• ダウンストリームヘルス API: http://127.0.0.1:3000/health として導出

browser -> Python agent -> recommendation MCP -> Rust recommendation API
                        -> reservation MCP -> NestJS reservation API

便利な環境変数:

• MOVIE_RESERVATION_GRAPHQL_URL

• MOVIE_RESERVATION_HEALTH_URL

• MOVIE_RESERVATION_API_TIMEOUT_SECONDS

• PORT

• HOST

Related MCP server: mcp-graphql-enhanced

ツール

• reservation_get_catalog

  • 入力: オプションの movie_id、オプションの fault、およびオプションの伝播フィールド。

  • GraphQL の movies と screenings(movieId) を呼び出します。

• reservation_request_seats

  • 入力: screening_id、seat_ids、オプションの fault、およびオプションの伝播フィールド。

  • GraphQL の requestReservation(input) を呼び出します。

• reservation_get_request_status

  • 入力: reservation_request_id、オプションの fault、およびオプションの伝播フィールド。

  • GraphQL の reservationRequestStatus(id) と reservationResult(requestId) を呼び出します。

• reservation_health

  • ダウンストリームの GET /health を呼び出します。

ツールが転送するもの:

• traceparent

• tracestate

• X-Correlation-Id

• X-Request-Id

• X-Demo-Fault

チェック

uv sync --frozen
uv run --frozen --no-sync pytest tests
uv run --frozen --no-sync pytest automation/tests
uv run --frozen --no-sync ruff check .
uv run --frozen --no-sync ruff format --check .
uv run --frozen --no-sync python -m compileall src tests automation

main へのプッシュは、Linux AMD64 の候補を sha-<commit> として GHCR に公開します。 CI は、候補をシングルイメージマニフェストに保つために BuildKit の自動レジストリアテステーションを 無効にし、その後、環境アドミッションゲートのために、公開されたダイジェストに対する明示的な GitHub ビルドの来歴を記録します。