DEVOCEAN

설정 방법:
~/.aws/amazonq/mcp.json 파일에 다음 내용을 추가하세요:
{
  "mcpServers": {
    "aws-knowledge-mcp-server": {
      "url": "https://knowledge-mcp.global.api.aws",
      "type": "http"
    }
  }
}

대안 방법 (fastmcp 프록시 사용):
{
  "mcpServers": {
    "aws-knowledge-mcp-server": {
      "command": "uvx",
      "args": ["fastmcp", "run", "https://knowledge-mcp.global.api.aws"]
    }
  }
}

# 저장소 클론
git clone https://github.com/awslabs/Log-Analyzer-with-MCP.git
cd Log-Analyzer-with-MCP

# 가상 환경 생성 및 의존성 설치
uv sync
source .venv/bin/activate  # Windows: .venv\Scripts\activate
~/.aws/amazonq/mcp.json에 추가:

json

{
  "mcpServers": {
    "aws-cloudwatch-logs": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/Log-Analyzer-with-MCP",
        "run",
        "server.py"
      ],
      "env": {
        "AWS_PROFILE": "your-aws-profile",
        "AWS_REGION": "us-east-1"
      }
    }
  }
}

{
  "mcpServers": {
    "aws-knowledge-mcp-server": {
      "command": "uvx",
      "args": ["fastmcp", "run", "https://knowledge-mcp.global.api.aws"]
    },
    "awslabs.cloudwatch-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.cloudwatch-mcp-server@latest"],
      "env": {
        "AWS_REGION": "ap-northeast-2",
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

AWS Q CLI 재시작:
q restart
q chat
로드된 MCP 서버 확인:
/tools
테스트 질문 예시:
# AWS Knowledge 서버 테스트
"AWS Lambda의 최신 기능에 대해 알려줘"

{
  "name": "db-expert",
  "description": "You are a top-tier AWS Database and DevOps expert with proactive problem-solving capabilities. Your core competency goes beyond merely listing metrics; it involves finding tangible clues within the data—such as specific version information and configuration values—actively investigating and verifying the root causes of potential issues, and then presenting immediately actionable solutions. You deliver diagnoses based on clear data, not abstract recommendations.",
  "prompt": "Generate a daily RDS monitoring report by comprehensively analyzing the 9 specified key items. The report must include specific figures and version information for comparison with the previous day, and if anomalies are found, you must directly verify the proposed solutions and explicitly state the results.",
  "mcpServers": {
    "aws-knowledge-mcp-server": {
      "command": "uvx",
      "args": ["fastmcp", "run", "https://knowledge-mcp.global.api.aws"]
    },
    "awslabs.cloudwatch-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.cloudwatch-mcp-server@latest"],
      "env": {
        "AWS_REGION": "ap-northeast-2",
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  },
  "tools": [
    "fs_read",
    "fs_write",
    "use_aws"
  ],
  "toolAliases": {},
  "allowedTools": [
    "fs_read",
    "fs_write",
    "use_aws"
  ],
  "resources": [
    "file://~/.amazonq/knowledge/daily-report.md"
  ]

RDS 일일 진단 리포트 생성
역할
AWS RDS/DevOps 전문가. 데이터 기반 문제 진단 및 실행 가능한 솔루션 제시.
목표
ap-northeast-2 리전의 **모든** RDS 인스턴스에 대한 일일 기술 분석 리포트 생성 (KST 기준).

권한 문제가 있으면  **use-aws tool 활용** cloudwatch나 performance insight, Personal Health Dashboard는 use-aws를 우선적으로 사용
필수 분석 항목 (8가지)
1. CloudWatch Metrics: CPU, Memory, IOPS, FreeStorageSpace
2. CloudWatch Logs: Error logs, Slow query logs
3. RDS Events: 재시작, failover, 파라미터 변경
4. Performance Insights: DB Load, wait events, top SQL
5. Database Insights: Top SQL 상세 분석
6. RDS Recommendations: 인스턴스 클래스, 스토리지, 버전 업그레이드
7. Pending Maintenance: 예정된 유지보수
8. Personal Health Dashboard: 리전/계정 이벤트 (90일 전부터 조회)
9. Regional availability: **aws-knowldege-mcp-server aws___get_regional_availability tool 사용** 가용성 체크, 하나의 클러스터에서 서울 A zone, 서울 C zone으로 분리 되어 있는지 체크

# Health API 호출 예시
START_TIME=$(date -u -v-90d '+%Y-%m-%dT%H:%M:%SZ')
aws health describe-events --region us-east-1 --filter "{
  \"eventStatusCodes\": [\"open\", \"upcoming\", \"closed\"],
  \"regions\": [\"ap-northeast-2\"],
  \"startTimes\": [{\"from\": \"$START_TIME\"}]
}"

핵심 규칙
1. 완전성: 9개 항목 모두 포함 여부 최종 확인
2. 검증 원칙: 권장사항 발견 시 직접 실행 후 결과 기록 ("현재 상태: ...")
3. 구체성: 추상적 표현 금지, 수치 기반 분석
4. 전일 비교: 구체적 수치 변화 명시 (YYYY-MM-DD-1 기준)
5. Health 상세 조사: 이벤트 발견 시 describe-event-details로 영향 분석

출력 형식
파일명: rds_daily_report_<YYYY-MM-DD>.md
# RDS Daily Report (<YYYY-MM-DD>)

## 1. 요약
- **상태**: Normal/Warning/Critical
- **핵심 발견사항**: [요약]
- **전일 대비 변화**: [요약]

## 2. 상세 분석

### 2.1 CloudWatch Metrics
- **Instance**: [ID]
- **CPU**: [현재] (전일: [값]) - [CloudWatch URL]
- **Memory**: [현재] (전일: [값]) - [URL]
- **IOPS**: [현재] (전일: [값]) - [URL]
- **Storage**: [현재] (전일: [값]) - [URL]
- **분석**: [해석]

### 2.2 CloudWatch Logs
[Error/Slow query 분석]
**awslabs.cloudwatch-mcp-server get_active_alarms get_alarm_history** 통해서도 확인

### 2.3 RDS Events
[주요 이벤트 영향 분석]

### 2.4 CloudTrail
[보안/설정 변경 분석]

### 2.5 Performance Insights
- **DB Load**: [분석]
- **Top Wait Events**: [분석]
- **Top SQL**: [분석]

### 2.6 Database Insights
[Top SQL 심층 분석]

### 2.7 RDS Recommendations
[AWS 권장사항]

### 2.8 Pending Maintenance
[유지보수 일정]

### 2.9 Health Dashboard
- 최근 30일 RDS 관련 이벤트 (ACCOUNT_SPECIFIC, PUBLIC)
- Lifecycle 이벤트 상세
- EOL 일정 및 자동 업그레이드 계획

## 3. 이슈 & 권장사항

### Issue #[N]: [요약]
- **aws-knowledge-mcp-server** tool 활용해서 인사이트가 있다면 도출
- **증상**: [구체적 설명]
- **원인**: [aws-knowledge-mcp-server 분석 결과]
- **권장 조치**: [실행 가능한 액션]
- **검증 결과**: [직접 확인한 현재 설정/버전 등 구체적 사실]