Amazon ECS MCP サーバーのツール設定 - Amazon Elastic Container Service
環境変数引数ツール

Amazon ECS MCP サーバーのツール設定

このガイドでは、フルマネージド Amazon ECS MCP サーバーで使用できるすべての設定について説明します。

注記

Amazon ECS MCP サーバーはプレビューリリースであり、変更される可能性があります。

環境変数

AWS_PROFILE (オプション)

使用する AWS の認証情報プロファイル名。--profile コマンドライン引数で上書きできます。

例:export AWS_PROFILE=dev

AWS_REGION (オプション)

SigV4 署名用の AWS リージョン。設定されていない場合は us-west-2 がデフォルトになります。

例:export AWS_REGION=us-west-2

引数

SigV4 MCP エンドポイント URL (必須)

接続先の MCP エンドポイント URL です。

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

--service (オプション)

SigV4 署名用の AWS のサービス名。指定されていない場合は、エンドポイントホスト名から自動検出されます。

例:--service ecs-mcp

--profile (オプション)

使用する AWS の認証情報プロファイル。指定されていない場合は、AWS_PROFILE 環境変数がデフォルトになります。

例:--profile dev

--region

使用する AWS リージョン。設定されていない場合は、AWS_REGION 環境変数を使用します。デフォルトは us-east-1 です。

例:--region us-west-2

--read-only (オプション)

書き込みアクセス許可が必要なツールを無効にします (書き込みアクセス許可を必要としないツールには readOnlyHint=true という注釈が付けられます)。デフォルトでは、すべてのツールが有効になっています。

例:--read-only

その他の設定オプションについては、「Configuration parameters」を参照してください。

ツール

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 のリストを返します。