Amazon ECS MCP 伺服器工具組態 - Amazon Elastic Container Service
環境變數引數工具

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Amazon ECS MCP 伺服器工具組態

本指南顯示全受管 Amazon ECS MCP Server 可用的所有組態。

注意

Amazon ECS MCP 伺服器目前為預覽版本，可能會有所變更。

環境變數

AWS_PROFILE （選用）

AWS 要使用的登入資料設定檔名稱；可由--profile命令列引數覆寫。

範例：export AWS_PROFILE=dev

AWS_REGION （選用）

AWS SigV4 簽署的區域；us-west-2如果未設定，則預設為 。

範例：export AWS_REGION=us-west-2

引數

SigV4 MCP 端點 URL （必要）

要連線的 MCP 端點 URL。

範例：https://ecs-mcp.us-west-2.api.aws/mcp

--service （選用）

AWS SigV4 簽署的服務名稱；若未提供，會自動從端點主機名稱偵測。

範例：--service ecs-mcp

--profile （選用）

AWS 要使用的 登入資料設定檔。如果未指定，則預設為AWS_PROFILE環境變數。

範例：--profile dev

--區域

AWS 要使用的區域。如果未設定 ，則使用AWS_REGION環境變數，預設為 us-east-1。

範例：--region us-west-2

--唯讀 （選用）

停用可能需要寫入許可的工具 （不需要寫入許可的工具會以 標註readOnlyHint=true)。預設會啟用所有工具。

範例：--read-only

如需更多組態選項，請參閱組態參數。

工具

Amazon ECS MCP 伺服器會公開下列 MCP 工具。

唯讀工具

get_deployment_status

此工具會檢查特定 Amazon ECS 叢集和服務的 Amazon ECS 部署狀態。

  • 必要的 IAM 動作：

    • ecs:DescribeServices

    • elasticloadbalancing:DescribeTargetGroups

    • elasticloadbalancing:DescribeLoadBalancers

  • 必要參數：

    • cluster_name （字串）：Amazon ECS 叢集名稱

    • service_name （字串）：Amazon ECS 服務名稱

  • 回應：工具會傳回與部署相關聯的部署狀態和詳細資訊。

fetch_service_events

此工具會擷取具有可自訂時段之診斷的 Amazon ECS 服務事件。

  • 必要的 IAM 動作：

    • ecs:DescribeServices

  • 必要參數：

    • cluster_name （字串）：Amazon ECS 叢集名稱

    • service_name （字串）：Amazon ECS 服務名稱

  • 選用的參數：

    • time_window （整數）：您可以用秒為單位提及時間範圍 （預設為 1 小時或 3600 秒）

    • start_time （字串）：ISO 格式的自訂開始時間

    • end_time （字串）：ISO 格式的自訂結束時間

  • 回應：工具會傳回具有摘要之服務的事件清單。

fetch_task_failures

此工具可協助您使用摘要擷取和分析 Amazon ECS 任務失敗。使用此工具，您可以識別任務失敗中的任何模式。

  • 必要的 IAM 動作：

    • ecs:ListTasks

    • ecs:DescribeTasks

  • 必要參數：

    • cluster_name （字串）：任務所在的 Amazon ECS 叢集名稱

  • 選用的參數：

    • service_name （字串）：您可以依特定服務篩選

    • time_window （整數）：您可以用秒為單位提及時間範圍 （預設為 1 小時或 3600 秒）

    • start_time （字串）：ISO 格式的自訂開始時間

    • end_time （字串）：ISO 格式的自訂結束時間

  • 回應：工具會傳回 TaskFailureResult，其中包含失敗的任務和摘要

fetch_task_logs

此工具會使用彈性的時間範圍選項擷取 Amazon ECS 任務的 CloudWatch 日誌。您可以使用此工具來疑難排解執行時間問題。

  • 必要的 IAM 動作：

    • ecs:DescribeServices

    • ecs:DescribeTaskDefinition

    • logs:FilterLogEvents

  • 必要參數：

    • cluster_name （字串）：Amazon ECS 叢集名稱

    • service_name （字串）：Amazon ECS 服務名稱

  • 選用的參數：

    • time_window （整數）：您可以用秒為單位提及時間範圍 （預設為 1 小時或 3600 秒）

    • start_time （字串）：ISO 格式的自訂開始時間

    • end_time （字串）：ISO 格式的自訂結束時間

    • log_group_name （字串）：指定 CloudWatch 日誌群組

  • 回應：工具會使用日誌項目傳回 TaskLogsResult

get_task_definition_deletion_blockers

此工具可識別可防止任務定義刪除的相依性。當您執行清除操作並了解阻止 Amazon ECS 資源刪除的原因時，此工具是適當的。

  • 必要的 IAM 動作：

    • ecs:ListClusters

    • ecs:ListServices

    • ecs:DescribeServices

    • ecs:ListTasks

    • ecs:DescribeTasks

  • 必要參數：

    • task_definition_arn （字串）：要分析的任務定義 Amazon Resource Name (ARN)

  • 回應：工具會傳回封鎖程式和刪除狀態

detect_image_pull_failures

此工具可協助您偵測和分類容器映像提取失敗。

  • 必要的 IAM 動作：

    • ecs:ListTasks

    • ecs:DescribeTasks

  • 必要參數：

    • cluster_name （字串）：Amazon ECS 叢集名稱

  • 選用的參數：

    • service_name （字串）：您可以依特定服務篩選

    • time_window （整數）：您可以用秒為單位提及時間範圍 （預設為 1 小時或 3600 秒）

    • start_time （字串）：ISO 格式的自訂開始時間

    • end_time （字串）：ISO 格式的自訂結束時間

  • 回應：工具會傳回失敗和摘要

fetch_network_configuration

此工具會擷取 Amazon ECS 服務網路組態詳細資訊。您可以使用此工具來了解 Amazon ECS 設定的 Amazon VPC、子網路、安全群組組態。

  • 必要的 IAM 動作：

    • ecs:DescribeServices

    • ec2:DescribeSecurityGroups

    • ec2:DescribeSubnets

  • 必要參數：

    • cluster_name （字串）：Amazon ECS 叢集名稱

    • service_name （字串）：Amazon ECS 服務名稱

  • 回應：工具會傳回 NetworkConfigurationResult 的清單，其中包含網路詳細資訊