View a markdown version of this page

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

get_security_recommendations

このツールは、AI を活用したセキュリティ分析を行うために Amazon ECS クラスターのセキュリティ設定データを収集します。IAM ロールとポリシー、ネットワーク設定 (セキュリティグループ、サブネット、パブリック IP)、タスク定義コンテナ設定、クラスターレベルの設定を収集します。AI アシスタントは、このデータを AWS のセキュリティのベストプラクティスと比較し、修復手順を含む、優先順位付けされた検出結果レポートを生成します。

  • 必須 IAM アクション:

    • ecs:DescribeClusters

    • ecs:ListServices

    • ecs:DescribeServices

    • ecs:DescribeTaskDefinition

    • ec2:DescribeSecurityGroups

    • ec2:DescribeSubnets

    • iam:GetRole

    • iam:ListAttachedRolePolicies

    • iam:GetPolicy

    • iam:GetPolicyVersion

    • iam:ListRolePolicies

    • iam:GetRolePolicy

  • 必須パラメータ:

    • cluster_name (文字列): 分析する Amazon ECS クラスター名

  • 任意指定のパラメータ:

    • service_name (文字列): 分析を 1 つのサービスにスコープします。省略した場合、クラスター内のすべてのサービスが分析されます。

    • max_services (整数): 分析するサービスの最大数 (デフォルトは 25、上限は 50)

  • レスポンス: このツールは、クラスター設定、サービス設定、タスク定義設定、ネットワークセキュリティの詳細、IAM ロールとポリシーデータ、コレクションの警告を返します。AI アシスタントはこのデータを使用して、修復ガイダンスを含む優先順位付けされたセキュリティ検出結果レポートを生成します。

ナレッジツール

これらのツールは、最新の AWS ドキュメントへのアクセスを提供します。AWS ナレッジ MCP サーバーを使用しており、発信者からの IAM アクセス許可は必要ありません。Amazon ECS MCP サービスはユーザーに代わってナレッジエンドポイントに接続します。

aws_knowledge_aws___search_documentation

このツールは、クエリに一致する関連ページを AWS ドキュメントで検索します。

  • 必須 IAM アクション: なし

  • 必須パラメータ:

    • search_phrase (文字列): AWS ドキュメントの検索クエリ

  • 任意指定のパラメータ:

    • topics (配列): 最大 3 つのトピック領域を検索 (デフォルトは ["general"])

    • limit (整数): トピックあたりの結果の最大数 (デフォルトは 5)

  • レスポンス: このツールは、タイトル、URL、コンテキストスニペットを含む一致するドキュメントページを返します。

aws_knowledge_aws__read_documentation

このツールは、AWS ドキュメントページの内容を読み取ってマークダウン形式で返します。

  • 必須 IAM アクション: なし

  • 必須パラメータ:

    • requests (配列): リクエストオブジェクトの配列。各オブジェクトには以下が含まれます。

      • url (文字列、必須): 読み取るドキュメントページの URL

      • max_length (整数、オプション): 返す最大文字数 (デフォルトは 10,000)

      • start_index (整数、オプション): 読み取りを開始する文字の位置 (デフォルトは 0)

  • レスポンス: ツールはドキュメントページの内容をマークダウン形式で返します。長いページは、ナビゲーションをサポートするチャンクで返されます。