Movie Reservation MCP

MCP-Wrapper für die Filmreservierungs-GraphQL-API.

Dieses Repository existiert, damit der Reservierungs-MCP einen eigenen Issue-Tracker, eine eigene CI und eine eigene Artefakt-Pipeline haben kann, während die Implementierung aus der golden-path/demo-Baseline extrahiert wird.

Ausführen

uv run movie-reservation-mcp

Der Produktionscontainer läuft als UID 10001 und lauscht auf Port 8091:

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

Die Demo geht davon aus, dass die MCP- und Reservierungs-API-Container einen gemeinsamen ECS-Task-Netzwerk-Namespace verwenden, sodass die Standard-Downstream-Adresse 127.0.0.1:3000 bleibt. Überschreiben Sie die Downstream-URLs, wenn Sie die Container unabhängig voneinander ausführen.

Standardwerte:

• MCP-Endpunkt: http://127.0.0.1:8091/mcp

• Health-Endpunkt: http://127.0.0.1:8091/health

• Downstream-GraphQL-API: http://127.0.0.1:3000/graphql

• Downstream-Health-API: abgeleitet als http://127.0.0.1:3000/health

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

Nützliche Umgebungsvariablen:

• MOVIE_RESERVATION_GRAPHQL_URL

• MOVIE_RESERVATION_HEALTH_URL

• MOVIE_RESERVATION_API_TIMEOUT_SECONDS

• PORT

• HOST

Related MCP server: mcp-graphql-enhanced

Werkzeuge

• reservation_get_catalog

  • Eingaben: optional movie_id, optional fault und optionale Propagationsfelder.

  • Ruft GraphQL movies und screenings(movieId) auf.

• reservation_request_seats

  • Eingaben: screening_id, seat_ids, optional fault und optionale Propagationsfelder.

  • Ruft GraphQL requestReservation(input) auf.

• reservation_get_request_status

  • Eingaben: reservation_request_id, optional fault und optionale Propagationsfelder.

  • Ruft GraphQL reservationRequestStatus(id) und reservationResult(requestId) auf.

• reservation_health

  • Ruft downstream GET /health auf.

Werkzeuge leiten weiter:

• traceparent

• tracestate

• X-Correlation-Id

• X-Request-Id

• X-Demo-Fault

Prüfungen

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

Push-Vorgänge auf main veröffentlichen einen Linux-AMD64-Kandidaten als sha-<commit> in GHCR. Die CI deaktiviert die automatische Registry-Attestierung von BuildKit, um den Kandidaten als Single-Image-Manifest zu erhalten, und zeichnet dann explizite GitHub-Build-Provenienz gegen den veröffentlichten Digest für das Umgebungs-Admission-Gate auf.