Amazon ECS MCP 伺服器入門 - Amazon Elastic Container Service
先決條件設定常見組態和最佳實務工具組態

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

Amazon ECS MCP 伺服器入門

本指南會逐步引導您設定 AI 程式碼助理並使用 Amazon ECS MCP Server 的步驟。您將了解如何設定環境、連線至伺服器，以及透過自然語言互動開始管理 Amazon ECS 叢集。

注意

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

先決條件

開始前，請確保您具備以下條件：

設定

確認 先決條件

檢查您的 Python 版本是否為 3.10 或更新版本

python3 --version

檢查 uv 安裝

uv --version

驗證 AWS CLI 組態

aws configure list

設定 IAM 許可

您需要 IAM 許可才能對 AWS 服務提出唯讀請求，並與 MCP 伺服器互動。您可以利用AWS 受管政策或單一自訂政策進行更精細的控制。

選項 1：合併受管和自訂政策

  1. 連接 AWS 受管政策 ReadOnlyAccess 以唯讀存取所有 AWS 服務

  2. 建立並連接 MCP 許可的其他自訂政策 （請參閱下面的 MCP 許可 JSON)

{
  "Version": "2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "MCPServerAccess",
      "Effect": "Allow",
      "Action": [
        "ecs-mcp:InvokeReadOnlyTools",
        "ecs-mcp:UseMcp"
      ],
      "Resource": "*"
    }
  ]
}

選項 2：單一自訂政策 （最精細的控制）

或者，您可以建立並連接包含 AWS 服務許可和 MCP 許可的單一自訂 JSON 政策：

{
  "Version": "2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "MCPServerAccess",
      "Effect": "Allow",
      "Action": [
        "ecs-mcp:InvokeReadOnlyTools",
        "ecs-mcp:UseMcp"
      ],
      "Resource": "*"
    },
    {
      "Sid": "ECSReadOnlyAccess",
      "Effect": "Allow",
      "Action": [
        "ecs:ListAccountSettings",
        "ecs:ListClusters",
        "ecs:ListContainerInstances",
        "ecs:ListTaskDefinitions",
        "ecs:ListServices",
        "ecs:ListServiceDeployments",
        "ecs:ListTasks",
        "ecs:DescribeClusters",
        "ecs:DescribeCapacityProviders",
        "ecs:DescribeContainerInstances",
        "ecs:DescribeTaskDefinition",
        "ecs:DescribeServices",
        "ecs:DescribeServiceDeployments",
        "ecs:DescribeServiceRevisions",
        "ecs:DescribeTaskSets",
        "ecs:DescribeTasks"
      ],
      "Resource": "*"
    },
    {
      "Sid": "CloudWatchLogsReadOnlyAccess",
      "Effect": "Allow",
      "Action": [
        "logs:DescribeLogGroups",
        "logs:DescribeLogStreams",
        "logs:GetLogEvents",
        "logs:FilterLogEvents"
      ],
      "Resource": "*"
    },
    {
      "Sid": "ELBReadOnlyAccess",
      "Effect": "Allow",
      "Action": [
        "elasticloadbalancing:DescribeLoadBalancers",
        "elasticloadbalancing:DescribeTargetGroups",
        "elasticloadbalancing:DescribeListeners"
      ],
      "Resource": "*"
    },
    {
      "Sid": "EC2ReadOnlyAccess",
      "Effect": "Allow",
      "Action": [
        "ec2:DescribeVpcs",
        "ec2:DescribeSubnets",
        "ec2:DescribeSecurityGroups",
        "ec2:DescribeRouteTables",
        "ec2:DescribeNetworkInterfaces"
      ],
      "Resource": "*"
    },
    {
      "Sid": "ECRReadOnlyAccess",
      "Effect": "Allow",
      "Action": [
        "ecr:DescribeRepositories",
        "ecr:DescribeImages"
      ],
      "Resource": "*"
    }
  ]
}

選擇並設定 AI 助理

安裝 MCP 相容 AI 助理或任何 MCP 相容工具。例如，您可以使用 Kiro、Cline、游標或 Claude Code。然後，將 AI 程式碼助理設定為透過 MCP Proxy 使用 Amazon ECS MCP 伺服器 AWS，這是安全、已驗證存取 Amazon ECS MCP 伺服器的必要項目。代理充當用戶端橋接器，使用本機 AWS 登入資料處理 AWS SigV4 身分驗證。以下範例使用 Kiro CLI。請遵循此連結，進一步了解如何在 Kiro 中設定 MCP。

尋找 MCP 組態檔案

  • macOS/Linux：

    ~/.kiro/settings/mcp.json

  • Windows：

    %USERPROFILE%\.kiro\settings\mcp.json

如果組態檔案不存在，請建立組態檔案。

新增 MCP 伺服器組態

請務必將區域 ({region}) 預留位置取代為您想要的區域 （例如 us-west-2)。如需區域的完整清單AWS Fargate 上的 Linux 容器，請參閱 。也請務必將{profile}預留位置取代為您的AWS CLI 設定檔名稱，例如 。 default

對於 Mac/Linux：

{
  "mcpServers": {
    "ecs-mcp": {
      "disabled": false,
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-proxy-for-aws@latest",
        "https://ecs-mcp.{region}.api.aws/mcp",
        "--service",
        "ecs-mcp",
        "--profile",
        "{profile}",
        "--region",
        "{region}"
      ]
    }
  }
}

用於 Windows：

{
  "mcpServers": {
    "ecs-mcp": {
      "disabled": false,
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "mcp-proxy-for-aws@latest",
        "mcp-proxy-for-aws.exe",
        "https://ecs-mcp.{region}.api.aws/mcp",
        "--service",
        "ecs-mcp",
        "--profile",
        "{profile}",
        "--region",
        "{region}"
      ]
    }
  }
}

驗證組態

重新啟動 Kiro CLI、kiro-cli，確認 MCP 伺服器已載入，/mcp並檢查可用的工具 /tools。

驗證您的設定

測試連線

向您的 AI 助理詢問簡單的問題，以驗證連線：

List all ECS clusters in my AWS account

您應該會看到 Amazon ECS 叢集的清單。

與使用 Amazon ECS MCP 伺服器的 AI 助理交談

範例 1：監控部署

Check deployment status for my web-service in production-cluster
Show me the ALB URL for my deployed service
Get service events for the last hour

範例 2：調查容器運作狀態

Show me all tasks that failed in the last 2 hours
Why are my containers failing health checks?
Display container logs for my api-service

範例 3：故障診斷

Analyze task failures in my production cluster
Check for image pull errors in the last 30 minutes
Why is my task definition stuck in DELETE_IN_PROGRESS state?

範例 4：檢查組態

Show me the network configuration for my web-service
What security groups are attached to my service?
List all VPC and subnet details for my ECS service

常見組態和最佳實務

多個 AWS 設定檔

如果您使用多個 AWS 帳戶，請建立個別的 MCP 伺服器組態。

對於 Mac/Linux：

{
  "mcpServers": {
    "ecs-mcp-prod": {
      "disabled": false,
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-proxy-for-aws@latest",
        "https://ecs-mcp.{region}.api.aws/mcp",
        "--service",
        "ecs-mcp",
        "--profile",
        "production",
        "--region",
        "us-west-2"
      ]
    },
    "ecs-mcp-dev": {
      "disabled": false,
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-proxy-for-aws@latest",
        "https://ecs-mcp.{region}.api.aws/mcp",
        "--service",
        "ecs-mcp",
        "--profile",
        "development",
        "--region",
        "us-east-1"
      ]
    }
  }
}

安全最佳實務

請勿透過允許的輸入機制傳遞秘密或敏感資訊：

  • 請勿在任何組態檔案中包含秘密或登入資料

  • 不要在提示中直接將敏感資訊傳遞給模型

  • 請勿在任務定義或服務組態中包含秘密

  • 避免在應用程式日誌中記錄敏感資訊

  • 使用 或 參數存放區來存放敏感資訊

工具組態

如需工具和組態的完整清單，請參閱 Amazon ECS MCP 伺服器工具組態。