# Amazon ECS MCP サーバーのツール設定
<a name="ecs-mcp-tool-configurations"></a>

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

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

## 環境変数
<a name="ecs-mcp-env-variables"></a>

**AWS\_PROFILE** (オプション)  
使用する AWS の認証情報プロファイル名。`--profile` コマンドライン引数で上書きできます。  
例:`export AWS_PROFILE=dev`

**AWS\_REGION** (オプション)  
SigV4 署名用の AWS リージョン。設定されていない場合は `us-west-2` がデフォルトになります。  
例:`export AWS_REGION=us-west-2`

## 引数
<a name="ecs-mcp-arguments"></a>

**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](https://github.com/aws/mcp-proxy-for-aws?tab=readme-ov-file#configuration-parameters)」を参照してください。

## ツール
<a name="ecs-mcp-tools"></a>

Amazon ECS MCP サーバーは、次の [MCP ツール](https://modelcontextprotocol.io/specification/2025-06-18/server/tools)を公開しています。

### 読み取り専用ツール
<a name="ecs-mcp-read-only-tools"></a>

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