Movie Recommendation MCP

Обёртка FastMCP вокруг API рекомендаций фильмов на Rust.

Этот репозиторий был выделен из 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 нижестоящего сервиса при независимом запуске контейнеров.

Значения по умолчанию:

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

• Endpoint проверки состояния: 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.

Контракт артефакта

Платформенная инфраструктура использует этот компонент как неизменяемый артефакт приложения, а не как исходный код:

• OCI-образ, собранный из Dockerfile этого репозитория.

• Ссылка на приватный образ ECR, зафиксированная по digest: <account>.dkr.ecr.<region>.amazonaws.com/movie-recommendation-mcp@sha256:<64-hex-digest>.

• Отдельный идентификатор релиза, например SHA коммита Git или версия релиза, записываемый вместе с digest потребляющим окружением или инфраструктурным репозиторием.

• Команда запуска: movie-recommendation-mcp.

• Порт контейнера и PORT по умолчанию: 8092.

• Endpoint MCP: /mcp.

• Endpoint проверки состояния: /health.

• Требуемая конфигурация времени выполнения задаётся через переменные окружения; URL нижестоящего API передаётся через 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 в GHCR как sha-<commit>. CI отключает автоматическую аттестацию BuildKit в реестре, чтобы кандидат оставался манифестом одного образа, а затем записывает для шлюза допуска окружения явное происхождение сборки GitHub для опубликованного digest.