View a markdown version of this page

Étapes pour créer une image Docker du serveur MCP - Générateur d'applications d'IA générative sur AWS
Étape 1 : Créez votre serveur MCPÉtape 2 : Testez votre serveur MCP localementÉtape 3 : Déploiement sur Amazon ECRÉtape 4 : Utiliser l'URI ECR dans GAAB

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Étapes pour créer une image Docker du serveur MCP

Pour utiliser les serveurs MCP (Model Context Protocol) avec Generative AI Application Builder sur AWS, vous devez d'abord créer une image Docker et la stocker dans un référentiel Amazon ECR privé.

Note

À l'heure actuelle, les serveurs MCP déployés dans Amazon Bedrock AgentCore Runtime ne peuvent pas être exportés vers GAAB. Pour que les serveurs MCP soient connectés à des agents créés via GAAB, ils doivent être créés via GAAB.

Étape 1 : Créez votre serveur MCP

Tout d'abord, vous devez avoir prêt à implémenter votre serveur MCP. Pour obtenir des instructions détaillées sur la création d'un serveur MCP, reportez-vous au manuel Amazon Bedrock AgentCore Developer Guide - Create an MCP server.

Nous recommandons la structure de projet suivante :

.
├── __init__.py
├── extras/
│   ├── extra_dependencies.py
│   ├── Dockerfile
├── requirements.txt
└── server.py <-- Server Entry point

Pour la structure Dockerfile, nous recommandons d'utiliser un format similaire à l'exemple suivant :

FROM ghcr.io/astral-sh/uv:python3.13-bookworm-slim
WORKDIR /app

# All environment variables in one layer
ENV UV_SYSTEM_PYTHON=1 \
    UV_COMPILE_BYTECODE=1 \
    UV_NO_PROGRESS=1 \
    PYTHONUNBUFFERED=1 \
    DOCKER_CONTAINER=1 \
    AWS_REGION=us-east-1 \
    AWS_DEFAULT_REGION=us-east-1

COPY requirements.txt requirements.txt
# Install from requirements file
RUN uv pip install -r requirements.txt

RUN uv pip install aws-opentelemetry-distro>=0.10.1

# Signal that this is running in Docker for host binding logic
ENV DOCKER_CONTAINER=1

# Create non-root user
RUN useradd -m -u 1000 bedrock_agentcore
USER bedrock_agentcore

EXPOSE 9000
EXPOSE 8000
EXPOSE 8080

# Copy entire project (respecting .dockerignore)
COPY . .

# Use the full module path
CMD ["opentelemetry-instrument", "python", "-m", "server"]

Étape 2 : Testez votre serveur MCP localement

Avant le déploiement sur AWS, il est important de tester votre serveur MCP localement pour vous assurer qu'il fonctionne comme prévu. Pour obtenir des instructions détaillées sur les tests locaux, reportez-vous au manuel Amazon Bedrock AgentCore Developer Guide - Testez votre serveur MCP localement.

Étape 3 : Déploiement sur Amazon ECR

Une fois votre serveur MCP créé et testé localement, procédez comme suit pour le déployer sur Amazon ECR :

  1. Assurez-vous que la dernière version de l'AWS CLI et de Docker est installée. Pour plus d'informations, consultez Getting Started with Amazon ECR.

  2. Récupérez un jeton d'authentification et authentifiez votre client Docker auprès de votre registre. Utilisez la CLI AWS :

    aws ecr get-login-password --region us-east-1 | docker login --username AWS --password-stdin <account-id>.dkr.ecr.us-east-1.amazonaws.com

  3. Créez votre image Docker à l'aide de la commande suivante. Pour plus d'informations sur la création d'un fichier Docker à partir de zéro, consultez la documentation Docker. Vous pouvez ignorer cette étape si votre image est déjà créée :

    docker build -t <repository-name> .

  4. Une fois la compilation terminée, balisez votre image afin de pouvoir la transférer vers ce référentiel :

    docker tag <repository-name>:latest <account-id>.dkr.ecr.us-east-1.amazonaws.com/<repository-name>:latest

  5. Exécutez la commande suivante pour transférer cette image vers le dépôt AWS que vous venez de créer :

    docker push <account-id>.dkr.ecr.us-east-1.amazonaws.com/<repository-name>:latest

Pour obtenir des instructions de déploiement complètes, reportez-vous au manuel Amazon Bedrock AgentCore Developer Guide - Déployez votre serveur MCP sur AWS.

Étape 4 : Utiliser l'URI ECR dans GAAB

Après avoir transféré avec succès votre image Docker vers Amazon ECR, copiez l'URI de l'image depuis la console ECR. Vous utiliserez cette URI lors du déploiement de votre serveur MCP via l'assistant de déploiement de Generative AI Application Builder sur AWS.