Movie Reservation MCP

Envoltorio MCP para la API GraphQL de reserva de películas.

Este repositorio existe para que el MCP de reservas pueda tener su propio rastreador de incidencias, CI y canalización de artefactos mientras la implementación se extrae de la base golden-path/demo.

Ejecución

uv run movie-reservation-mcp

El contenedor de producción se ejecuta como UID 10001 y escucha en el puerto 8091:

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

La demo asume que los contenedores del MCP y de la API de reservas comparten un mismo espacio de nombres de red de tarea ECS, por lo que la dirección downstream predeterminada sigue siendo 127.0.0.1:3000. Sobrescribe las URL downstream al ejecutar los contenedores de forma independiente.

Valores predeterminados:

• Endpoint MCP: http://127.0.0.1:8091/mcp

• Endpoint de salud: http://127.0.0.1:8091/health

• API GraphQL downstream: http://127.0.0.1:3000/graphql

• API de salud downstream: se deriva como http://127.0.0.1:3000/health

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

Variables de entorno útiles:

• MOVIE_RESERVATION_GRAPHQL_URL

• MOVIE_RESERVATION_HEALTH_URL

• MOVIE_RESERVATION_API_TIMEOUT_SECONDS

• PORT

• HOST

Related MCP server: mcp-graphql-enhanced

Herramientas

• reservation_get_catalog

  • Entradas: movie_id opcional, fault opcional y campos de propagación opcionales.

  • Llama a GraphQL movies y screenings(movieId).

• reservation_request_seats

  • Entradas: screening_id, seat_ids, fault opcional y campos de propagación opcionales.

  • Llama a GraphQL requestReservation(input).

• reservation_get_request_status

  • Entradas: reservation_request_id, fault opcional y campos de propagación opcionales.

  • Llama a GraphQL reservationRequestStatus(id) y reservationResult(requestId).

• reservation_health

  • Llama al GET /health downstream.

Las herramientas reenvían:

• traceparent

• tracestate

• X-Correlation-Id

• X-Request-Id

• X-Demo-Fault

Comprobaciones

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

Los pushes a main publican un candidato Linux AMD64 en GHCR como sha-<commit>. CI desactiva la atestación automática de registro de BuildKit para mantener el candidato como un manifiesto de imagen única, y luego registra la procedencia explícita de la compilación de GitHub contra el digest publicado para la puerta de admisión del entorno.