Konfigurationen des Amazon ECS MCP-Servertools

Dieses Handbuch zeigt alle Konfigurationen, die für den vollständig verwalteten Amazon ECS MCP Server verfügbar sind.

Anmerkung

Der Amazon ECS MCP-Server befindet sich in der Vorschauversion und kann sich ändern.

Umgebungsvariablen

AWS_PROFILE (optional)

AWS Name des zu verwendenden Anmeldeinformationsprofils; kann durch das Befehlszeilenargument außer Kraft gesetzt werden. --profile

Beispiel: export AWS_PROFILE=dev

AWS_REGION (optional)

AWS Region für die Sigv4-Signatur; standardmäßig auf, falls nicht festgelegt. us-west-2

Beispiel: export AWS_REGION=us-west-2

Argumente

URL des SigV4-MCP-Endpunkts (erforderlich)

Die MCP-Endpunkt-URL, zu der eine Verbindung hergestellt werden soll.

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

--service (optional)

AWS Dienstname für die SigV4-Signatur; wird automatisch anhand des Endpunkt-Hostnamens erkannt, falls nicht angegeben.

Beispiel: --service ecs-mcp

--profile (optional)

AWS Zu verwendendes Anmeldeinformationsprofil. Standardmäßig wird die AWS_PROFILE Umgebungsvariable verwendet, wenn sie nicht angegeben ist.

Beispiel: --profile dev

--region

AWS zu verwendende Region. Verwendet die AWS_REGION Umgebungsvariable, wenn sie nicht gesetzt ist, standardmäßig. us-east-1

Beispiel: --region us-west-2

--read-only (optional)

Deaktiviert Tools, die möglicherweise Schreibrechte benötigen (Tools, die KEINE Schreibrechte benötigen, sind mit Anmerkungen versehen). readOnlyHint=true Standardmäßig sind alle Tools aktiviert.

Beispiel: --read-only

Weitere Konfigurationsoptionen finden Sie unter Konfigurationsparameter.

Tools

Der Amazon ECS MCP-Server stellt die folgenden MCP-Tools zur Verfügung.

Tools, die nur lesbar sind

get_deployment_status

Das Tool überprüft Ihren Amazon ECS-Bereitstellungsstatus für einen bestimmten Amazon ECS-Cluster und -Service.

• Erforderliche IAM-Aktionen:

  • ecs:DescribeServices

  • elasticloadbalancing:DescribeTargetGroups

  • elasticloadbalancing:DescribeLoadBalancers

• Erforderliche Parameter

  • cluster_name(string): Name des Amazon ECS-Clusters

  • service_name(string): Amazon ECS-Servicename

• Antwort: Das Tool gibt den Bereitstellungsstatus und die mit der Bereitstellung verbundenen Details zurück.

fetch_service_events

Dieses Tool ruft Amazon ECS-Serviceereignisse für Diagnosen mit anpassbaren Zeitfenstern ab.

• Erforderliche IAM-Aktionen:

  • ecs:DescribeServices

• Erforderliche Parameter

  • cluster_name(string): Name des Amazon ECS-Clusters

  • service_name(string): Amazon ECS-Servicename

• Optionale Parameter

  • time_window(Ganzzahl): Sie können ein Zeitfenster in Sekunden angeben (Standard ist 1 Stunde oder 3600 Sekunden)

  • start_time(Zeichenfolge): Benutzerdefinierte Startzeit im ISO-Format

  • end_time(string): Benutzerdefinierte Endzeit im ISO-Format

• Antwort: Das Tool gibt eine Liste der Ereignisse für den Service mit Zusammenfassung zurück.

fetch_task_failures

Dieses Tool hilft Ihnen beim Abrufen und Analysieren von Amazon ECS-Aufgabenfehlern mit Zusammenfassungen. Mit diesem Tool können Sie alle Muster bei Aufgabenfehlern identifizieren.

• Erforderliche IAM-Aktionen:

  • ecs:ListTasks

  • ecs:DescribeTasks

• Erforderliche Parameter

  • cluster_name(string): Name des Amazon ECS-Clusters, in dem sich Ihre Aufgabe befindet

• Optionale Parameter

  • service_name(string): Sie können nach einem bestimmten Service filtern

  • time_window(Ganzzahl): Sie können ein Zeitfenster in Sekunden angeben (Standard ist 1 Stunde oder 3600 Sekunden)

  • start_time(Zeichenfolge): Benutzerdefinierte Startzeit im ISO-Format

  • end_time(string): Benutzerdefinierte Endzeit im ISO-Format

• Antwort: Das Tool kehrt TaskFailureResult mit fehlgeschlagenen Aufgaben und einer Zusammenfassung zurück

fetch_task_logs

Dieses Tool ruft CloudWatch Protokolle für Amazon ECS-Aufgaben mit flexiblen Zeitbereichsoptionen ab. Sie verwenden dieses Tool zur Behebung von Laufzeitproblemen.

• Erforderliche IAM-Aktionen:

  • ecs:DescribeServices

  • ecs:DescribeTaskDefinition

  • logs:FilterLogEvents

• Erforderliche Parameter

  • cluster_name(string): Name des Amazon ECS-Clusters

  • service_name(string): Amazon ECS-Servicename

• Optionale Parameter

  • time_window(Ganzzahl): Sie können ein Zeitfenster in Sekunden angeben (Standard ist 1 Stunde oder 3600 Sekunden)

  • start_time(Zeichenfolge): Benutzerdefinierte Startzeit im ISO-Format

  • end_time(string): Benutzerdefinierte Endzeit im ISO-Format

  • log_group_name(string): Geben Sie die CloudWatch Protokollgruppe an

• Antwort: Das Tool kehrt TaskLogsResult mit Protokolleinträgen zurück

get_task_definition_deletion_blockers

Dieses Tool identifiziert Abhängigkeiten, die das Löschen von Aufgabendefinitionen verhindern können. Das Tool eignet sich, wenn Sie Bereinigungsvorgänge ausführen und wissen, was das Löschen von Amazon ECS-Ressourcen verhindert.

• Erforderliche IAM-Aktionen:

  • ecs:ListClusters

  • ecs:ListServices

  • ecs:DescribeServices

  • ecs:ListTasks

  • ecs:DescribeTasks

• Erforderliche Parameter

  • task_definition_arn(string): Zu analysierende Aufgabendefinition Amazon Resource Name (ARN)

• Antwort: Das Tool gibt die Blocker und den Löschstatus zurück

detect_image_pull_failures

Dieses Tool hilft Ihnen dabei, Fehler beim Abrufen von Container-Images zu erkennen und zu kategorisieren.

• Erforderliche IAM-Aktionen:

  • ecs:ListTasks

  • ecs:DescribeTasks

• Erforderliche Parameter

  • cluster_name(string): Name des Amazon ECS-Clusters

• Optionale Parameter

  • service_name(string): Sie können nach einem bestimmten Service filtern

  • time_window(Ganzzahl): Sie können ein Zeitfenster in Sekunden angeben (Standard ist 1 Stunde oder 3600 Sekunden)

  • start_time(Zeichenfolge): Benutzerdefinierte Startzeit im ISO-Format

  • end_time(string): Benutzerdefinierte Endzeit im ISO-Format

• Antwort: Das Tool gibt die Fehler und eine Zusammenfassung zurück

fetch_network_configuration

Dieses Tool ruft Netzwerkkonfigurationsdetails für den Amazon ECS-Service ab. Sie können dieses Tool verwenden, um die Amazon VPC-, Subnetz- und Sicherheitsgruppenkonfiguration Ihres Amazon ECS-Setups zu verstehen.

• Erforderliche IAM-Aktionen:

  • ecs:DescribeServices

  • ec2:DescribeSecurityGroups

  • ec2:DescribeSubnets

• Erforderliche Parameter

  • cluster_name(string): Name des Amazon ECS-Clusters

  • service_name(string): Amazon ECS-Servicename

• Antwort: Das Tool gibt eine Liste NetworkConfigurationResult mit Netzwerkdetails zurück