Movie Recommendation MCP

围绕 Rust 电影推荐 API 的 FastMCP 包装器。

该仓库是从 movie-reservation-platform-lab/movie-recommendation-service/axum-tools-mcp 中提取的，以便 MCP 组件可以拥有独立的 CI 和制品流水线。

运行

uv run movie-recommendation-mcp

生产容器以 UID 10001 运行，并监听端口 8092：

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

演示假设 MCP 和推荐 API 容器共享同一个 ECS 任务网络命名空间，因此默认下游地址保持为 127.0.0.1:8082。在独立运行容器时，覆盖下游 URL。

默认值：

• MCP 端点：http://127.0.0.1:8092/mcp

• 健康端点：http://127.0.0.1:8092/health

• 下游 API：http://127.0.0.1:8082

有用的环境变量：

• MOVIE_RECOMMENDATION_API_URL

• AXUM_TOOLS_API_URL，用于与原始演示提取保持兼容

• PORT

• HOST

• OTEL_SERVICE_NAME

• OTEL_EXPORTER_OTLP_ENDPOINT

• OTEL_EXPORTER_OTLP_PROTOCOL

• OTEL_RESOURCE_ATTRIBUTES

Related MCP server: Weather Info MCP Server

工具

• recommendation_get_movies

  • 输入：limit、可选的 preference、可选的 fault、可选的 traceparent、可选的 tracestate、可选的 correlation_id、可选的 request_id 和可选的 demo_fault。

  • 调用 Rust GET /recommendations。

  • 成功响应体：{"ok": true, "service_name": "movie-recommendation-mcp", "fault": "<fault-or-none>", "recommendations": [...]}

  • 下游错误响应体：{"ok": false, "service_name": "movie-recommendation-mcp", "fault": "<fault-or-none>", "status_code": <int>, "error": "recommendation_dependency_failed"}

• recommendation_health

  • 输入：可选的 traceparent、可选的 tracestate、可选的 correlation_id、可选的 request_id 和可选的 demo_fault。

  • 调用 Rust GET /health。

  • 成功响应体：{"ok": true, "service_name": "movie-recommendation-mcp", "health": {...}}

两个工具都会转发：

• traceparent

• tracestate

• X-Correlation-Id

• X-Request-Id

• X-Demo-Fault

提取决策

• 对于此提取切片，保持内部 Python 导入路径为 axum_tools_mcp。公共包、控制台脚本、服务名称、镜像和仓库均已命名为 movie-recommendation-mcp；重命名导入路径只会增加无谓的改动，而不会改变代理所消费的外部 MCP 契约。

• 保留工具名称 recommendation_get_movies 和 recommendation_health。经过验证的 reservation-agent 演示将 recommendation_get_movies 列入白名单，并使用 limit、preference、fault 和传播参数调用它。

• 保留 AXUM_TOOLS_API_URL 作为兼容性回退，但在新的运行时配置中优先使用 MOVIE_RECOMMENDATION_API_URL。

制品契约

平台基础设施将此组件作为不可变的应用制品来消费，而非源代码：

• 从该仓库的 Dockerfile 构建的 OCI 镜像。

• 由摘要固定的私有 ECR 镜像引用：<account>.dkr.ecr.<region>.amazonaws.com/movie-recommendation-mcp@sha256:<64-hex-digest>。

• 独立的发布标识符（如 Git 提交 SHA 或发布版本），由消费方环境/基础设施仓库随摘要一并记录。

• 运行时命令：movie-recommendation-mcp。

• 容器端口及默认 PORT：8092。

• MCP 端点：/mcp。

• 健康端点：/health。

• 所需运行时配置由环境驱动；下游 API URL 通过 MOVIE_RECOMMENDATION_API_URL 或兼容性回退 AXUM_TOOLS_API_URL 提供。

• 部署组成、环境清单、提升状态和 AWS 资源均保留在此仓库之外。

检查

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 构建出处，用于环境准入门禁。