Movie Reservation MCP

영화 예약 GraphQL API용 MCP 래퍼입니다.

이 저장소는 구현이 golden-path/demo 베이스라인에서 추출되는 동안 예약 MCP가 자체 이슈 트래커, 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 컨테이너가 하나의 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 후보를 GHCR에 sha-<commit>로 게시합니다. CI는 후보를 단일 이미지 매니페스트로 유지하기 위해 BuildKit의 자동 레지스트리 증명을 비활성화한 다음, 환경 승인 게이트를 위해 게시된 다이제스트에 대한 명시적 GitHub 빌드 출처를 기록합니다.