View a markdown version of this page

Configurazioni degli strumenti del server Amazon ECS MCP - Amazon Elastic Container Service
Variabili di ambienteArguments (Argomenti)Tools (Strumenti)

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Configurazioni degli strumenti del server Amazon ECS MCP

Questa guida mostra tutte le configurazioni disponibili per il server MCP Amazon ECS completamente gestito.

Nota

Il server Amazon ECS MCP è in versione di anteprima ed è soggetto a modifiche.

Variabili di ambiente

AWS_PROFILE (opzionale)

AWS nome del profilo delle credenziali da utilizzare; può essere sovrascritto dall'argomento della riga di comando. --profile

Ad esempio: export AWS_PROFILE=dev

AWS_REGION (opzionale)

AWS regione per la firma SigV4; il valore predefinito è se non è impostato. us-west-2

Ad esempio: export AWS_REGION=us-west-2

Arguments (Argomenti)

URL dell'endpoint MCP SigV4 (richiesto)

L'URL dell'endpoint MCP a cui connettersi.

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

--service (opzionale)

AWS nome del servizio per la firma SigV4; rilevato automaticamente dal nome host dell'endpoint se non fornito.

Ad esempio: --service ecs-mcp

--profile (opzionale)

AWS profilo di credenziali da usare. Il valore predefinito è la variabile di AWS_PROFILE ambiente se non specificata.

Ad esempio: --profile dev

--region

AWS regione da usare. Utilizza la variabile di AWS_REGION ambiente se non è impostata, il valore predefinito è. us-east-1

Ad esempio: --region us-west-2

--read-only (opzionale)

Disabilita gli strumenti che potrebbero richiedere permessi di scrittura (gli strumenti che NON richiedono permessi di scrittura sono annotati con). readOnlyHint=true Per impostazione predefinita, tutti gli strumenti sono abilitati.

Ad esempio: --read-only

Per ulteriori opzioni di configurazione, vedere Parametri di configurazione.

Tools (Strumenti)

Il server Amazon ECS MCP espone i seguenti strumenti MCP.

Strumenti di sola lettura

get_deployment_status

Lo strumento verifica lo stato della distribuzione di Amazon ECS per un determinato cluster e servizio Amazon ECS.

  • Azioni IAM richieste:

    • ecs:DescribeServices

    • elasticloadbalancing:DescribeTargetGroups

    • elasticloadbalancing:DescribeLoadBalancers

  • Parametri obbligatori:

    • cluster_name(stringa): nome del cluster Amazon ECS

    • service_name(stringa): nome del servizio Amazon ECS

  • Risposta: lo strumento restituisce lo stato della distribuzione e i dettagli associati alla distribuzione.

fetch_service_events

Questo strumento recupera gli eventi del servizio Amazon ECS per la diagnostica con finestre temporali personalizzabili.

  • Azioni IAM richieste:

    • ecs:DescribeServices

  • Parametri obbligatori:

    • cluster_name(stringa): nome del cluster Amazon ECS

    • service_name(stringa): nome del servizio Amazon ECS

  • Parametri facoltativi:

    • time_window(numero intero): puoi indicare una finestra temporale in secondi (l'impostazione predefinita è 1 ora o 3600 secondi)

    • start_time(stringa): ora di inizio personalizzata in formato ISO

    • end_time(string): Ora di fine personalizzata in formato ISO

  • Risposta: Lo strumento restituisce l'elenco degli eventi per il servizio con un riepilogo.

fetch_task_failures

Questo strumento ti aiuta a recuperare e analizzare gli errori delle attività di Amazon ECS con riepiloghi. Utilizzando questo strumento, puoi identificare qualsiasi modello di fallimento delle attività.

  • Azioni IAM richieste:

    • ecs:ListTasks

    • ecs:DescribeTasks

  • Parametri obbligatori:

    • cluster_name(stringa): nome del cluster Amazon ECS in cui risiede l'attività

  • Parametri facoltativi:

    • service_name(stringa): puoi filtrare per servizio specifico

    • time_window(numero intero): Puoi indicare una finestra temporale in secondi (l'impostazione predefinita è 1 ora o 3600 secondi)

    • start_time(stringa): ora di inizio personalizzata in formato ISO

    • end_time(string): Ora di fine personalizzata in formato ISO

  • Risposta: Lo strumento restituisce TaskFailureResult le attività non riuscite e il riepilogo

fetch_task_logs

Questo strumento recupera CloudWatch i log per le attività di Amazon ECS con opzioni di intervallo di tempo flessibili. Questo strumento viene utilizzato per risolvere i problemi di runtime.

  • Azioni IAM richieste:

    • ecs:DescribeServices

    • ecs:DescribeTaskDefinition

    • logs:FilterLogEvents

  • Parametri obbligatori:

    • cluster_name(stringa): nome del cluster Amazon ECS

    • service_name(stringa): nome del servizio Amazon ECS

  • Parametri facoltativi:

    • time_window(numero intero): puoi indicare una finestra temporale in secondi (l'impostazione predefinita è 1 ora o 3600 secondi)

    • start_time(stringa): ora di inizio personalizzata in formato ISO

    • end_time(string): Ora di fine personalizzata in formato ISO

    • log_group_name(stringa): Specificare il gruppo di CloudWatch log

  • Risposta: lo strumento restituisce TaskLogsResult le voci di registro

get_task_definition_deletion_blockers

Questo strumento identifica le dipendenze che possono impedire l'eliminazione delle definizioni delle attività. Lo strumento è adatto quando si eseguono operazioni di pulizia e si capisce cosa impedisce l'eliminazione delle risorse di Amazon ECS.

  • Azioni IAM richieste:

    • ecs:ListClusters

    • ecs:ListServices

    • ecs:DescribeServices

    • ecs:ListTasks

    • ecs:DescribeTasks

  • Parametri obbligatori:

    • task_definition_arn(stringa): definizione dell'attività Amazon Resource Name (ARN) da analizzare

  • Risposta: lo strumento restituisce i blocchi e lo stato di eliminazione

detect_image_pull_failures

Questo strumento consente di rilevare e classificare gli errori di pull delle immagini dei contenitori.

  • Azioni IAM richieste:

    • ecs:ListTasks

    • ecs:DescribeTasks

  • Parametri obbligatori:

    • cluster_name(stringa): nome del cluster Amazon ECS

  • Parametri facoltativi:

    • service_name(stringa): puoi filtrare per servizio specifico

    • time_window(numero intero): Puoi indicare una finestra temporale in secondi (l'impostazione predefinita è 1 ora o 3600 secondi)

    • start_time(stringa): ora di inizio personalizzata in formato ISO

    • end_time(string): Ora di fine personalizzata in formato ISO

  • Risposta: Lo strumento restituisce gli errori e il riepilogo

fetch_network_configuration

Questo strumento recupera i dettagli di configurazione della rete del servizio Amazon ECS. Puoi utilizzare questo strumento per comprendere la configurazione di Amazon VPC, sottorete e gruppo di sicurezza della tua configurazione Amazon ECS.

  • Azioni IAM richieste:

    • ecs:DescribeServices

    • ec2:DescribeSecurityGroups

    • ec2:DescribeSubnets

  • Parametri obbligatori:

    • cluster_name(stringa): nome del cluster Amazon ECS

    • service_name(stringa): nome del servizio Amazon ECS

  • Risposta: lo strumento restituisce un elenco NetworkConfigurationResult con dettagli di rete

get_security_recommendations

Questo strumento raccoglie i dati di configurazione della sicurezza del cluster Amazon ECS per l'analisi AI-powered della sicurezza. Raccoglie ruoli e politiche IAM, impostazioni di rete (gruppi di sicurezza, sottoreti, IP pubblico), impostazioni del contenitore di definizione delle attività e configurazione a livello di cluster. Il tuo assistente AI confronta questi dati con le migliori pratiche di AWS sicurezza e genera un rapporto sui risultati classificato per priorità con le fasi di correzione.

  • Azioni IAM richieste:

    • ecs:DescribeClusters

    • ecs:ListServices

    • ecs:DescribeServices

    • ecs:DescribeTaskDefinition

    • ec2:DescribeSecurityGroups

    • ec2:DescribeSubnets

    • iam:GetRole

    • iam:ListAttachedRolePolicies

    • iam:GetPolicy

    • iam:GetPolicyVersion

    • iam:ListRolePolicies

    • iam:GetRolePolicy

  • Parametri obbligatori:

    • cluster_name(stringa): nome del cluster Amazon ECS da analizzare

  • Parametri facoltativi:

    • service_name(stringa): analisi dell'ambito di un singolo servizio. Se omesso, vengono analizzati tutti i servizi del cluster.

    • max_services(numero intero): numero massimo di servizi da analizzare (impostazione predefinita 25, limitato a 50)

  • Risposta: lo strumento restituisce la configurazione del cluster, le configurazioni dei servizi, le impostazioni di definizione delle attività, i dettagli sulla sicurezza della rete, i dati relativi ai ruoli e alle policy IAM ed eventuali avvisi di raccolta. Il tuo assistente AI utilizza questi dati per generare un rapporto prioritario sui risultati di sicurezza con indicazioni sulla correzione.

Strumenti di conoscenza

Questi strumenti forniscono l'accesso a AWS documentazione aggiornata. Sono alimentati dal AWS Knowledge MCP Server e non richiedono alcuna autorizzazione IAM da parte del chiamante: il servizio Amazon ECS MCP si connette all'endpoint Knowledge per tuo conto.

aws_knowledge_aws___search_documentation

Questo strumento cerca nella documentazione le pagine pertinenti che corrispondono a una query. AWS

  • Azioni IAM richieste: nessuna

  • Parametri obbligatori:

    • search_phrase(stringa): query di ricerca per la AWS documentazione

  • Parametri facoltativi:

    • topics(array): Fino a 3 aree tematiche in cui effettuare la ricerca (impostazione predefinita["general"])

    • limit(numero intero): numero massimo di risultati per argomento (impostazione predefinita 5)

  • Risposta: lo strumento restituisce le pagine di documentazione corrispondenti con titoli, URL e frammenti di contesto.

aws_knowledge_aws___read_documentation

Questo strumento legge il contenuto delle pagine di documentazione e le restituisce in formato markdown. AWS

  • Azioni IAM richieste: nessuna

  • Parametri obbligatori:

    • requests(array): matrice di oggetti di richiesta. Ogni oggetto contiene:

      • url(stringa, obbligatorio): URL della pagina di documentazione da leggere

      • max_length(numero intero, opzionale): numero massimo di caratteri da restituire (impostazione predefinita 10000)

      • start_index(numero intero, opzionale): posizione del carattere da cui iniziare la lettura (impostazione predefinita 0)

  • Risposta: Lo strumento restituisce il contenuto della pagina di documentazione in formato markdown. Le pagine lunghe vengono restituite in blocchi con il supporto alla navigazione.

aws_knowledge_aws___recommend

Questo strumento restituisce pagine di documentazione correlate per un determinato URL di documentazione. AWS

  • Azioni IAM richieste: nessuna

  • Parametri obbligatori:

    • url(stringa): un URL di AWS documentazione (deve essere una pagina docs.aws.amazon.com)

  • Risposta: Lo strumento fornisce consigli per le pagine di AWS documentazione correlate suddivise in quattro categorie: popolari, nuove, simili e più comuni.