Amazon ECS MCP 服务器工具配置 - Amazon Elastic Container Service
环境变量参数工具
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

Amazon ECS MCP 服务器工具配置

本指南展示了可用于完全托管的 Amazon ECS MCP 服务器的所有配置。

注意

Amazon ECS MCP 服务器目前为预览版，可能会发生变化。

环境变量

AWS_PROFILE（可选）

要使用的 Amazon 凭证配置文件名称；可以通过命令行参数 --profile 覆盖。

示例：export AWS_PROFILE=dev

AWS_REGION（可选）

用于 SigV4 签名的 Amazon 区域；如果未设置，则默认为 us-west-2。

示例：export AWS_REGION=us-west-2

参数

SigV4 MCP 端点 URL（必需）

要连接到的 MCP 端点。

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

--service（可选）

用于 SigV4 签名的 Amazon 服务名称；如果未提供，则会从端点主机名自动检测。

示例：--service ecs-mcp

--profile（可选）

要使用的 Amazon 凭证配置文件。如果未指定，则默认为 AWS_PROFILE 环境变量。

示例：--profile dev

region。

要使用的 Amazon 区域。如果未设置，则使用 AWS_REGION 环境变量，默认为 us-east-1。

示例：--region us-west-2

--read-only（可选）

禁用可能需要写入权限的工具（不需要写入权限的工具会标注 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 资源名称 (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 列表以及网络详细信息