# Amazon ECS MCP 서버 도구 구성
<a name="ecs-mcp-tool-configurations"></a>

이 가이드에서는 완전관리형 Amazon ECS MCP 서버에 사용할 수 있는 모든 구성을 보여줍니다.

**참고**  
Amazon ECS MCP 서버는 Amazon ECS 미리 보기 릴리스에 있으므로 변경될 수 있습니다.

## 환경 변수
<a name="ecs-mcp-env-variables"></a>

**AWS\$1PROFILE**(선택 사항)  
사용할 AWS 자격 증명 프로파일 이름. `--profile` 명령줄 인수로 재정의할 수 있습니다.  
예시: `export AWS_PROFILE=dev`

**AWS\$1REGION**(선택 사항)  
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`

** 리전**  
사용할 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\$1deployment\$1status**  
이 도구는 특정 Amazon ECS 클러스터 및 서비스에 대한 Amazon ECS 배포 상태를 확인합니다.  
+ 필요한 IAM 작업:
  + `ecs:DescribeServices`
  + `elasticloadbalancing:DescribeTargetGroups`
  + `elasticloadbalancing:DescribeLoadBalancers`
+ 필요한 파라미터:
  + `cluster_name`(문자열): Amazon ECS 클러스터 이름
  + `service_name`(문자열): Amazon ECS 서비스 이름
+ 응답: 도구는 배포 상태 및 배포와 관련된 세부 정보를 반환합니다.

**fetch\$1service\$1events**  
이 도구는 사용자 지정 가능한 기간이 설정된 진단이 있는지 Amazon ECS 서비스 이벤트를 검색합니다.  
+ 필요한 IAM 작업:
  + `ecs:DescribeServices`
+ 필요한 파라미터:
  + `cluster_name`(문자열): Amazon ECS 클러스터 이름
  + `service_name`(문자열): Amazon ECS 서비스 이름
+ 선택적 파라미터:
  + `time_window`(정수): 기간을 초 단위로 언급할 수 있습니다(기본값은 1시간 또는 3,600초).
  + `start_time`(문자열): ISO 형식의 사용자 지정 시작 시간
  + `end_time`(문자열): ISO 형식의 사용자 지정 종료 시간
+ 응답: 도구는 요약과 함께 서비스에 대한 이벤트 목록을 반환합니다.

**fetch\$1task\$1failures**  
이 도구는 요약을 사용하여 Amazon ECS 태스크 장애를 검색하고 분석하는 데 도움이 됩니다. 이 도구를 사용하면 태스크 장애의 패턴을 식별할 수 있습니다.  
+ 필요한 IAM 작업:
  + `ecs:ListTasks`
  + `ecs:DescribeTasks`
+ 필요한 파라미터:
  + `cluster_name`(문자열): 태스크가 상주하는 Amazon ECS 클러스터 이름
+ 선택적 파라미터:
  + `service_name`(문자열): 특정 서비스를 기준으로 필터링할 수 있습니다.
  + `time_window`(정수): 기간을 초 단위로 언급할 수 있습니다(기본값은 1시간 또는 3,600초).
  + `start_time`(문자열): ISO 형식의 사용자 지정 시작 시간
  + `end_time`(문자열): ISO 형식의 사용자 지정 종료 시간
+ 응답: 도구는 장애가 발생한 태스크 및 요약과 함께 TaskFailureResult를 반환합니다.

**fetch\$1task\$1logs**  
이 도구는 유연한 시간 범위 옵션을 사용하여 Amazon ECS 태스크에 대한 CloudWatch 로그를 검색합니다. 이 도구를 사용하여 런타임 문제를 해결할 수 있습니다.  
+ 필요한 IAM 작업:
  + `ecs:DescribeServices`
  + `ecs:DescribeTaskDefinition`
  + `logs:FilterLogEvents`
+ 필요한 파라미터:
  + `cluster_name`(문자열): Amazon ECS 클러스터 이름
  + `service_name`(문자열): Amazon ECS 서비스 이름
+ 선택적 파라미터:
  + `time_window`(정수): 기간을 초 단위로 언급할 수 있습니다(기본값은 1시간 또는 3,600초).
  + `start_time`(문자열): ISO 형식의 사용자 지정 시작 시간
  + `end_time`(문자열): ISO 형식의 사용자 지정 종료 시간
  + `log_group_name`(문자열): CloudWatch 로그 그룹 지정
+ 응답: 도구는 로그 항목과 함께 TaskLogsResult를 반환합니다.

**get\$1task\$1definition\$1deletion\$1blockers**  
이 도구는 태스크 정의 삭제를 방해할 수 있는 종속성을 식별합니다. 이 도구는 정리 작업을 실행하고 Amazon ECS 리소스 삭제를 방해하는 요소를 이해하는 데 적합합니다.  
+ 필요한 IAM 작업:
  + `ecs:ListClusters`
  + `ecs:ListServices`
  + `ecs:DescribeServices`
  + `ecs:ListTasks`
  + `ecs:DescribeTasks`
+ 필요한 파라미터:
  + `task_definition_arn`(문자열): 분석할 태스크 정의 Amazon 리소스 이름(ARN)
+ 응답: 도구는 블로커 및 삭제 상태를 반환합니다.

**detect\$1image\$1pull\$1failures**  
이 도구는 컨테이너 이미지 가져오기 장애를 감지하고 분류하는 데 도움이 됩니다.  
+ 필요한 IAM 작업:
  + `ecs:ListTasks`
  + `ecs:DescribeTasks`
+ 필요한 파라미터:
  + `cluster_name`(문자열): Amazon ECS 클러스터 이름
+ 선택적 파라미터:
  + `service_name`(문자열): 특정 서비스를 기준으로 필터링할 수 있습니다.
  + `time_window`(정수): 기간을 초 단위로 언급할 수 있습니다(기본값은 1시간 또는 3,600초).
  + `start_time`(문자열): ISO 형식의 사용자 지정 시작 시간
  + `end_time`(문자열): ISO 형식의 사용자 지정 종료 시간
+ 응답: 도구는 장애 및 요약을 반환합니다.

**fetch\$1network\$1configuration**  
이 도구는 Amazon ECS 서비스 네트워크 구성 세부 정보를 검색합니다. 이 도구를 사용하여 Amazon ECS 설정의 Amazon VPC, 서브넷, 보안 그룹 구성을 이해할 수 있습니다.  
+ 필요한 IAM 작업:
  + `ecs:DescribeServices`
  + `ec2:DescribeSecurityGroups`
  + `ec2:DescribeSubnets`
+ 필요한 파라미터:
  + `cluster_name`(문자열): Amazon ECS 클러스터 이름
  + `service_name`(문자열): Amazon ECS 서비스 이름
+ 응답: 도구는 네트워크 세부 정보와 함께 NetworkConfigurationResult 목록을 반환합니다.