# EBS CloudWatch Metrics MCP

AWS EBS CloudWatch 지표 계산 MCP 서버입니다. Kiro에서 EBS 볼륨의 성능 지표를 조회하고 분석할 수 있습니다.

## 기능

- **IOPS 계산**: 읽기/쓰기 IOPS 평균, 최대, 최소 값 계산
- **처리량 계산**: 읽기/쓰기 처리량 (MB/s) 계산
- **스냅샷 조회**: 스냅샷 크기 및 목록 조회
- **CloudWatch 지표 조회**: 모든 EBS CloudWatch 지표 직접 조회
- **고급 지표 계산**: I/O 사용률, 지연 시간, 버스팅 IOPS/처리량 등

## 설치

### uvx 사용 (권장)

```bash
uvx ebs-cloudwatch-metrics-mcp
```

### pip 사용

```bash
pip install ebs-cloudwatch-metrics-mcp
```

### 소스에서 설치

```bash
git clone https://github.com/your-repo/ebs-cloudwatch-metrics-mcp.git
cd ebs-cloudwatch-metrics-mcp
pip install -e .
```

## Kiro MCP 설정

`.kiro/settings/mcp.json` 파일에 다음 설정을 추가하세요:

```json
{
  "mcpServers": {
    "ebs-cloudwatch-metrics": {
      "command": "uvx",
      "args": ["ebs-cloudwatch-metrics-mcp"],
      "env": {
        "AWS_PROFILE": "default",
        "AWS_REGION": "ap-northeast-2"
      }
    }
  }
}
```

### 환경 변수

| 변수 | 설명 | 기본값 |
|------|------|--------|
| `AWS_PROFILE` | AWS 프로파일 이름 | `default` |
| `AWS_REGION` | AWS 리전 | 프로파일 설정 |
| `AWS_ACCESS_KEY_ID` | AWS 액세스 키 ID | - |
| `AWS_SECRET_ACCESS_KEY` | AWS 시크릿 액세스 키 | - |

## 사용 가능한 도구

### 1. calculate_iops

EBS 볼륨의 IOPS를 계산합니다.

**파라미터:**
- `volume_id` (필수): EBS 볼륨 ID
- `start_time` (필수): 조회 시작 시간 (ISO 8601)
- `end_time` (필수): 조회 종료 시간 (ISO 8601)
- `period`: 지표 수집 간격 (초, 기본값: 300)
- `region`: AWS 리전

**예시:**
```
calculate_iops(
  volume_id="vol-1234567890abcdef0",
  start_time="2024-01-01T00:00:00Z",
  end_time="2024-01-02T00:00:00Z"
)
```

### 2. calculate_throughput

EBS 볼륨의 처리량을 계산합니다.

**파라미터:**
- `volume_id` (필수): EBS 볼륨 ID
- `start_time` (필수): 조회 시작 시간 (ISO 8601)
- `end_time` (필수): 조회 종료 시간 (ISO 8601)
- `period`: 지표 수집 간격 (초, 기본값: 300)
- `region`: AWS 리전

### 3. get_snapshot_size

EBS 스냅샷의 크기를 조회합니다.

**파라미터:**
- `snapshot_id` (필수): EBS 스냅샷 ID
- `region`: AWS 리전

### 4. list_volume_snapshots

EBS 볼륨의 모든 스냅샷 목록을 조회합니다.

**파라미터:**
- `volume_id` (필수): EBS 볼륨 ID
- `max_results`: 최대 결과 수 (기본값: 100)
- `region`: AWS 리전

### 5. get_ebs_metric

특정 EBS CloudWatch 지표를 조회합니다.

**파라미터:**
- `volume_id` (필수): EBS 볼륨 ID
- `metric_name` (필수): CloudWatch 지표 이름
- `start_time` (필수): 조회 시작 시간 (ISO 8601)
- `end_time` (필수): 조회 종료 시간 (ISO 8601)
- `period`: 지표 수집 간격 (초, 기본값: 300)
- `statistics`: 통계 유형 배열 (기본값: ["Average"])
- `region`: AWS 리전

**지원되는 지표:**
- `VolumeReadOps` - 읽기 작업 수
- `VolumeWriteOps` - 쓰기 작업 수
- `VolumeReadBytes` - 읽기 바이트 수
- `VolumeWriteBytes` - 쓰기 바이트 수
- `VolumeTotalReadTime` - 총 읽기 시간
- `VolumeTotalWriteTime` - 총 쓰기 시간
- `VolumeIdleTime` - 유휴 시간
- `VolumeQueueLength` - 큐 길이
- `VolumeThroughputPercentage` - 처리량 백분율
- `VolumeConsumedReadWriteOps` - 소비된 읽기/쓰기 작업
- `BurstBalance` - 버스트 잔액 (gp2)

### 6. list_ebs_metrics

사용 가능한 EBS CloudWatch 지표 목록을 반환합니다.

**파라미터:** 없음

### 7. get_advanced_metrics

EBS 볼륨의 고급 성능 지표를 계산합니다.

**파라미터:**
- `volume_id` (필수): EBS 볼륨 ID
- `start_time` (필수): 조회 시작 시간 (ISO 8601)
- `end_time` (필수): 조회 종료 시간 (ISO 8601)
- `period`: 지표 수집 간격 (초, 기본값: 300)
- `region`: AWS 리전

**반환되는 고급 지표:**
- `io_use_percent` - I/O 사용률 (%)
- `avg_read_latency_ms` - 평균 읽기 지연 시간 (ms)
- `avg_write_latency_ms` - 평균 쓰기 지연 시간 (ms)
- `read_io_size_kib` - 읽기 I/O 크기 (KiB)
- `write_io_size_kib` - 쓰기 I/O 크기 (KiB)
- `avg_read_iops` - 평균 읽기 IOPS
- `avg_write_iops` - 평균 쓰기 IOPS
- `avg_total_iops` - 평균 총 IOPS
- `avg_read_throughput_mib_s` - 평균 읽기 처리량 (MiB/s)
- `avg_write_throughput_mib_s` - 평균 쓰기 처리량 (MiB/s)
- `avg_total_throughput_mib_s` - 평균 총 처리량 (MiB/s)
- `bursting_read_iops` - 버스팅 읽기 IOPS
- `bursting_write_iops` - 버스팅 쓰기 IOPS
- `bursting_total_iops` - 버스팅 총 IOPS
- `bursting_read_throughput_mib_s` - 버스팅 읽기 처리량 (MiB/s)
- `bursting_write_throughput_mib_s` - 버스팅 쓰기 처리량 (MiB/s)
- `bursting_total_throughput_mib_s` - 버스팅 총 처리량 (MiB/s)
- `burst_balance` - BurstBalance (gp2 볼륨만)

## 필요한 IAM 권한

MCP 서버를 사용하려면 다음 IAM 권한이 필요합니다:

```json
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "cloudwatch:GetMetricStatistics",
        "cloudwatch:ListMetrics"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "ec2:DescribeSnapshots",
        "ec2:DescribeVolumes"
      ],
      "Resource": "*"
    }
  ]
}
```

### 최소 권한 정책

특정 볼륨만 조회하려면 리소스를 제한할 수 있습니다:

```json
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "cloudwatch:GetMetricStatistics"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "cloudwatch:namespace": "AWS/EBS"
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": [
        "ec2:DescribeSnapshots"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "ec2:VolumeId": "vol-1234567890abcdef0"
        }
      }
    }
  ]
}
```

## 라이선스

MIT License