Movie Reservation MCP

MCP wrapper for the movie reservation GraphQL API.

此仓库的存在是为了让预订 MCP 拥有自己的问题跟踪器、CI 和制品流水线，而实现则从 golden-path/demo 基线中提取。

运行

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 候选版本以 sha-<commit> 的形式发布到 GHCR。CI 会禁用 BuildKit 的自动注册表证明，以保持候选版本为单镜像清单，然后针对已发布的摘要记录显式的 GitHub 构建来源，用于环境准入门禁。