View a markdown version of this page

Configurazioni degli strumenti del server MCP di Amazon ECS - 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 MCP di Amazon ECS

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 è impostata. us-west-2

Ad esempio: export AWS_REGION=us-west-2

Arguments (Argomenti)

URL dell'endpoint MCP Sigv4 (obbligatorio)

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 delle credenziali da usare. Il valore predefinito è la variabile di AWS_PROFILE ambiente se non specificata.

Ad esempio: --profile dev

--region

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

Ad esempio: --region us-west-2

--sola lettura (opzionale)

Disabilita gli strumenti che potrebbero richiedere autorizzazioni di scrittura (gli strumenti che NON richiedono autorizzazioni di scrittura sono contrassegnati 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 di distribuzione di Amazon ECS per un particolare 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(stringa): 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 errore 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 menzionare 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(stringa): ora di fine personalizzata in formato ISO

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

fetch_task_logs

Questo strumento recupera i CloudWatch log per le attività di Amazon ECS con opzioni di intervallo di tempo flessibili. Puoi utilizzare questo strumento 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(stringa): ora di fine personalizzata in formato ISO

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

  • Risposta: lo strumento restituisce TaskLogsResult le voci del registro

get_task_definition_deletion_blockers

Questo strumento identifica le dipendenze che possono impedire l'eliminazione delle definizioni delle attività. Lo strumento è appropriato 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 estrazione 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 menzionare 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(stringa): 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 di servizi 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 i dettagli della rete

get_security_recommendations

Questo strumento raccoglie i dati di configurazione della sicurezza del cluster Amazon ECS per l'analisi della sicurezza. AI-powered Raccoglie ruoli e policy 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 con 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, con un limite massimo di 50)

  • Risposta: lo strumento restituisce la configurazione del cluster, le configurazioni dei servizi, le impostazioni di definizione delle attività, i dettagli di sicurezza della rete, i dati sui ruoli e le policy IAM ed eventuali avvisi di raccolta. L'assistente AI utilizza questi dati per generare un report con priorità sui risultati della sicurezza con indicazioni sulla risoluzione.

fetch_action_logs

Usa questo strumento per recuperare i log delle azioni di Amazon ECS e risolvere i problemi relativi alle operazioni del ciclo di vita dei container. Con Action Logs, ottieni visibilità sulle operazioni lato servizio che Amazon ECS esegue per tuo conto, tra cui allegati ENI, image pull, registrazioni di load balancer, limitazione dei tentativi ed errori di autorizzazione. Usa questo strumento quando le attività non vengono avviate, le distribuzioni si bloccano o hai bisogno di capire cosa ha fatto Amazon ECS durante un'operazione. Lo strumento restituisce le voci del registro delle azioni se gli Action Logs sono abilitati per il cluster o un messaggio di stato se gli Action Logs non sono configurati.

  • Azioni IAM richieste:

    • ecs:DescribeClusters

    • logs:DescribeDeliverySources

    • logs:DescribeDeliveries

    • logs:DescribeDeliveryDestinations

    • logs:FilterLogEvents

  • Parametri obbligatori:

    • cluster_name: il nome o l'ARN del cluster Amazon ECS.

  • Parametri facoltativi:

    • service_name: il nome del servizio Amazon ECS in base al quale filtrare i log delle azioni.

    • task_id: l'ARN o l'ID dell'attività in base al quale filtrare i log delle azioni.

    • deployment_id: l'ID di distribuzione in base al quale filtrare i registri delle azioni.

    • log_level: il filtro a livello di registro. I valori validi sono ERROR, WARN o INFO.

    • time_window: La finestra temporale in secondi. Il valore predefinito è 3.600 secondi.

    • start_time: L'ora di inizio personalizzata in formato ISO.

    • end_time: L'ora di fine personalizzata in formato ISO.

  • Risposta:

    Lo strumento restituisce lo stato di rilevamento dei registri delle azioni per il cluster. Se i log delle azioni sono abilitati con una destinazione CloudWatch Logs, lo strumento restituisce anche le voci di registro corrispondenti. Ogni voce include un timestamp, un livello di registro, un nome dell'evento, l'ARN della risorsa e i dettagli dell'evento. I risultati sono limitati a 1.000 voci. Per recuperare dati più mirati, utilizza finestre temporali più ristrette o filtri aggiuntivi.

Strumenti di conoscenza

Questi strumenti forniscono l'accesso a una 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 di conoscenza 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): interrogazione di ricerca per la AWS documentazione

  • Parametri facoltativi:

    • topics(array): fino a 3 aree tematiche in cui cercare (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 per la navigazione.