Configurations de l'outil du serveur Amazon ECS MCP - Amazon Elastic Container Service
Variables d’environnementArgumentsOutils

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.

Configurations de l'outil du serveur Amazon ECS MCP

Ce guide présente toutes les configurations disponibles pour le serveur Amazon ECS MCP entièrement géré.

Note

Le serveur Amazon ECS MCP est en version préliminaire et est sujet à modification.

Variables d’environnement

AWS_PROFILE (facultatif)

AWS nom du profil d'identification à utiliser ; peut être remplacé par l'argument de --profile ligne de commande.

Exemple : export AWS_PROFILE=dev

AWS_REGION (facultatif)

AWS région pour la signature SigV4 ; la valeur par défaut est us-west-2 si elle n'est pas définie.

Exemple : export AWS_REGION=us-west-2

Arguments

URL du point de terminaison MCP SigV4 (obligatoire)

URL du point de terminaison MCP auquel se connecter.

Exemple : https://ecs-mcp.us-west-2.api.aws/mcp

--service (facultatif)

AWS nom du service pour la signature SigV4 ; détecté automatiquement à partir du nom d'hôte du terminal s'il n'est pas fourni.

Exemple : --service ecs-mcp

--profile (facultatif)

AWS profil d'identification à utiliser. La valeur par défaut est la variable d'AWS_PROFILEenvironnement si elle n'est pas spécifiée.

Exemple : --profile dev

--région

AWS région à utiliser. Utilise la variable d'AWS_REGIONenvironnement si elle n'est pas définie, la valeur par défaut estus-east-1.

Exemple : --region us-west-2

--lecture seule (facultatif)

Désactivez les outils qui peuvent nécessiter des autorisations d'écriture (les outils qui NE nécessitent PAS d'autorisations d'écriture sont annotés avecreadOnlyHint=true). Par défaut, tous les outils sont activés.

Exemple : --read-only

Pour plus d'options de configuration, consultez la section Paramètres de configuration.

Outils

Le serveur Amazon ECS MCP expose les outils MCP suivants.

Outils en lecture seule

get_deployment_status

L'outil vérifie l'état de votre déploiement Amazon ECS pour un cluster et un service Amazon ECS spécifiques.

  • Actions IAM requises :

    • ecs:DescribeServices

    • elasticloadbalancing:DescribeTargetGroups

    • elasticloadbalancing:DescribeLoadBalancers

  • Paramètres obligatoires :

    • cluster_name(chaîne) : nom du cluster Amazon ECS

    • service_name(chaîne) : nom du service Amazon ECS

  • Réponse : L'outil renvoie l'état du déploiement et les détails associés au déploiement.

fetch_service_events

Cet outil récupère les événements du service Amazon ECS à des fins de diagnostic avec des fenêtres temporelles personnalisables.

  • Actions IAM requises :

    • ecs:DescribeServices

  • Paramètres obligatoires :

    • cluster_name(chaîne) : nom du cluster Amazon ECS

    • service_name(chaîne) : nom du service Amazon ECS

  • Paramètres facultatifs :

    • time_window(entier) : vous pouvez mentionner une fenêtre horaire en secondes (la valeur par défaut est 1 heure ou 3 600 secondes)

    • start_time(chaîne) : heure de début personnalisée au format ISO

    • end_time(chaîne) : heure de fin personnalisée au format ISO

  • Réponse : L'outil renvoie la liste des événements du service avec un résumé.

fetch_task_failure

Cet outil vous permet de récupérer et d'analyser les échecs de tâches Amazon ECS à l'aide de résumés. À l'aide de cet outil, vous pouvez identifier les modèles d'échec des tâches.

  • Actions IAM requises :

    • ecs:ListTasks

    • ecs:DescribeTasks

  • Paramètres obligatoires :

    • cluster_name(chaîne) : nom du cluster Amazon ECS où réside votre tâche

  • Paramètres facultatifs :

    • service_name(chaîne) : Vous pouvez filtrer par service spécifique

    • time_window(entier) : vous pouvez mentionner une fenêtre horaire en secondes (la valeur par défaut est 1 heure ou 3 600 secondes)

    • start_time(chaîne) : heure de début personnalisée au format ISO

    • end_time(chaîne) : heure de fin personnalisée au format ISO

  • Réponse : L'outil revient TaskFailureResult avec les tâches ayant échoué et un résumé

fetch_task_logs

Cet outil extrait CloudWatch les journaux des tâches Amazon ECS avec des options de plage de temps flexibles. Vous utilisez cet outil pour résoudre les problèmes d'exécution.

  • Actions IAM requises :

    • ecs:DescribeServices

    • ecs:DescribeTaskDefinition

    • logs:FilterLogEvents

  • Paramètres obligatoires :

    • cluster_name(chaîne) : nom du cluster Amazon ECS

    • service_name(chaîne) : nom du service Amazon ECS

  • Paramètres facultatifs :

    • time_window(entier) : vous pouvez mentionner une fenêtre horaire en secondes (la valeur par défaut est 1 heure ou 3 600 secondes)

    • start_time(chaîne) : heure de début personnalisée au format ISO

    • end_time(chaîne) : heure de fin personnalisée au format ISO

    • log_group_name(chaîne) : Spécifiez le groupe de CloudWatch journaux

  • Réponse : L'outil revient TaskLogsResult avec des entrées de journal

get_task_definition_deletion_blockers

Cet outil identifie les dépendances qui peuvent empêcher la suppression des définitions de tâches. L'outil est approprié lorsque vous exécutez des opérations de nettoyage et que vous comprenez ce qui empêche la suppression des ressources Amazon ECS.

  • Actions IAM requises :

    • ecs:ListClusters

    • ecs:ListServices

    • ecs:DescribeServices

    • ecs:ListTasks

    • ecs:DescribeTasks

  • Paramètres obligatoires :

    • task_definition_arn(string) : définition de la tâche Amazon Resource Name (ARN) à analyser

  • Réponse : L'outil renvoie les bloqueurs et l'état de suppression

detect_image_pull_failure

Cet outil vous aide à détecter et à classer les échecs d'extraction d'images de conteneurs.

  • Actions IAM requises :

    • ecs:ListTasks

    • ecs:DescribeTasks

  • Paramètres obligatoires :

    • cluster_name(chaîne) : nom du cluster Amazon ECS

  • Paramètres facultatifs :

    • service_name(chaîne) : Vous pouvez filtrer par service spécifique

    • time_window(entier) : vous pouvez mentionner une fenêtre horaire en secondes (la valeur par défaut est 1 heure ou 3 600 secondes)

    • start_time(chaîne) : heure de début personnalisée au format ISO

    • end_time(chaîne) : heure de fin personnalisée au format ISO

  • Réponse : L'outil renvoie les échecs et un résumé

fetch_configuration du réseau

Cet outil récupère les détails de configuration du réseau du service Amazon ECS. Vous pouvez utiliser cet outil pour comprendre la configuration Amazon VPC, sous-réseau et groupe de sécurité de votre configuration Amazon ECS.

  • Actions IAM requises :

    • ecs:DescribeServices

    • ec2:DescribeSecurityGroups

    • ec2:DescribeSubnets

  • Paramètres obligatoires :

    • cluster_name(chaîne) : nom du cluster Amazon ECS

    • service_name(chaîne) : nom du service Amazon ECS

  • Réponse : L'outil renvoie une liste NetworkConfigurationResult avec les détails du réseau