5. Q CLI 기반 MCP 구성하기 2

Update : 2025.08.06

1. 브라우저 접근 (Playwright + Chrome)

에이전트(Amazon Q CLI)가 웹 브라우저를 통해 인터넷에 접근할 수 있도록 설정하면, 매우 다양한 유스케이스를 지원할 수 있게 됩니다. 이 예제에서는 CLI가 Playwright를 통해 Chrome 브라우저에 접근할 수 있도록 MCP 서버를 설정합니다. 해당 MCP 서버는 GitHub에서 사용할 수 있습니다.

1.1 현재 채팅 세션 종료 및 Chrome 설치

  • 채팅 세션 종료

/quit
  • Chrome 설치

sudo dnf install -y https://dl.google.com/linux/direct/google-chrome-stable_current_x86_64.rpm

1.2 mcp.json 파일 업데이트

앞서 설정했던 MCP 설정 파일을 업데이트 합니다.

code-server ~/.aws/amazonq/mcp.json

다음 내용으로 파일을 업데이트합니다.

{
  "mcpServers": {
    "awslabs.eks-mcp-server": {
      "command": "uvx",
      "args": [
        "awslabs.eks-mcp-server@latest",
        "--allow-write",
        "--allow-sensitive-data-access"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "autoApprove": [],
      "disabled": false
    },
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest",
        "--headless",
        "--executable-path",
        "/usr/bin/google-chrome-stable"
      ]
    }
  }
}

1.3 CLI 채팅 세션 재시작

q chat 

출력 예시:

$ q
✓ playwright loaded in 1.09 s
✓ awslabs.eks-mcp-server loaded in 1.71 s


    ⢠⣶⣶⣦⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣤⣶⣿⣿⣿⣶⣦⡀⠀
 ⠀⠀⠀⣾⡿⢻⣿⡆⠀⠀⠀⢀⣄⡄⢀⣠⣤⣤⡀⢀⣠⣤⣤⡀⠀⠀⢀⣠⣤⣤⣤⣄⠀⠀⢀⣤⣤⣤⣤⣤⣤⡀⠀⠀⣀⣤⣤⣤⣀⠀⠀⠀⢠⣤⡀⣀⣤⣤⣄⡀⠀⠀⠀⠀⠀⠀⢠⣿⣿⠋⠀⠀⠀⠙⣿⣿⡆
 ⠀⠀⣼⣿⠇⠀⣿⣿⡄⠀⠀⢸⣿⣿⠛⠉⠻⣿⣿⠛⠉⠛⣿⣿⠀⠀⠘⠛⠉⠉⠻⣿⣧⠀⠈⠛⠛⠛⣻⣿⡿⠀⢀⣾⣿⠛⠉⠻⣿⣷⡀⠀⢸⣿⡟⠛⠉⢻⣿⣷⠀⠀⠀⠀⠀⠀⣼⣿⡏⠀⠀⠀⠀⠀⢸⣿⣿
 ⠀⢰⣿⣿⣤⣤⣼⣿⣷⠀⠀⢸⣿⣿⠀⠀⠀⣿⣿⠀⠀⠀⣿⣿⠀⠀⢀⣴⣶⣶⣶⣿⣿⠀⠀⠀⣠⣾⡿⠋⠀⠀⢸⣿⣿⠀⠀⠀⣿⣿⡇⠀⢸⣿⡇⠀⠀⢸⣿⣿⠀⠀⠀⠀⠀⠀⢹⣿⣇⠀⠀⠀⠀⠀⢸⣿⡿
 ⢀⣿⣿⠋⠉⠉⠉⢻⣿⣇⠀⢸⣿⣿⠀⠀⠀⣿⣿⠀⠀⠀⣿⣿⠀⠀⣿⣿⡀⠀⣠⣿⣿⠀⢀⣴⣿⣋⣀⣀⣀⡀⠘⣿⣿⣄⣀⣠⣿⣿⠃⠀⢸⣿⡇⠀⠀⢸⣿⣿⠀⠀⠀⠀⠀⠀⠈⢿⣿⣦⣀⣀⣀⣴⣿⡿⠃
 ⠚⠛⠋⠀⠀⠀⠀⠘⠛⠛⠀⠘⠛⠛⠀⠀⠀⠛⠛⠀⠀⠀⠛⠛⠀⠀⠙⠻⠿⠟⠋⠛⠛⠀⠘⠛⠛⠛⠛⠛⠛⠃⠀⠈⠛⠿⠿⠿⠛⠁⠀⠀⠘⠛⠃⠀⠀⠘⠛⠛⠀⠀⠀⠀⠀⠀⠀⠀⠙⠛⠿⢿⣿⣿⣋⠀⠀
 ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠛⠿⢿⡧

╭─────────────────────────────── Did you know? ────────────────────────────────╮
│                                                                              │
│       You can specify wait time (in ms) for mcp server loading with q        │
│     settings mcp.initTimeout {timeout in int}. Servers that takes longer     │
│ than the specified time will continue to load in the background. Use /tools  │
│                           to see pending servers.                            │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯

/help all commands  •  ctrl + j new lines  •  ctrl + s fuzzy search
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🤖 You are chatting with claude-4-sonnet

1.4 사용 가능한 도구 목록 확인

사용 가능한 도구 목록 확인 프롬프트:

사용가능한 Tool들을 알려줘.

예시 출력:

playwright__로 시작하는 브라우저 도구들이 포함되어 있을 것입니다.

> 사용 가능한 도구들을 카테고리별로 정리하여 ~/output/available_tools.md 파일에 저장했습니다.

주요 도구 카테고리는 다음과 같습니다:

1. EKS 관련 도구 - Kubernetes 클러스터 관리, 리소스 배포, 로그 조회
2. CloudWatch 도구 - 메트릭 및 로그 모니터링
3. IAM 도구 - 권한 관리
4. 브라우저 도구 - 웹 자동화
5. 파일 시스템 도구 - 파일 읽기/쓰기
6. AWS CLI 도구 - AWS 서비스 관리

현재 설정된 EKS 클러스터 eksworkshop과 기본 리전 ap-northeast-2를 활용하여 이 도구들을 사용할 수 있습니다. 특정 도구에 대해 더 자세한 정보가 필요하시면 언제든 말씀해 주세요!

2. 웹 탐색 및 요약 요청 예시

웹 탐색 및 요약 요청 프롬프트:

https://docs.aws.amazon.com/eks/latest/best-practices 페이지로 이동하여 비용최적화 섹션을 정리해줘..
브라우저는 이미 설치되어 있으며, 전체 과정은 하나의 탭에서만 진행해 주세요.

💡 Q CLI는 내부적으로 Playwright를 통해 Chrome을 실행하고, 해당 페이지를 탐색한 뒤 비용최적화 섹션의 내용을 요약하여 제공합니다.

출력 결과 예시:

> AWS EKS 모범 사례 가이드의 비용 최적화 섹션을 성공적으로 정리하여 ~/output/eks_cost_optimization_best_practices.md 파일에 저장했습니다.

## 정리된 주요 내용:

### 1. 일반 가이드라인
• 인프라 독립성 확보
• 최적화된 컨테이너 인스턴스 선택
• 다양한 구매 옵션 활용 (On-Demand, Spot, Savings Plan)

### 2. 비용 최적화 프레임워크 (CFM Framework)
• **See 기둥**: 측정 및 책임 (태깅 전략, 모니터링, KPI 정의)
• **Save 기둥**: 비용 최적화 (낭비 제거, 아키텍처 설계, 구매 옵션 선택)
• **Plan 기둥**: 계획 및 예측 (예산, 비즈니스 가치 정량화)
• **Run 기둥**: 운영 (지속적인 개선 프로세스)

### 3. 주요 비용 동인
1. 컴퓨팅 비용 (Compute Costs)
2. 네트워킹 비용 (Networking Costs)  
3. 스토리지 비용 (Storage Costs)

### 4. 핵심 도구 및 서비스
• Amazon CloudWatch Container Insights
• Kubecost
• AWS Cost Explorer
• Cloud Intelligence Dashboards
• AWS Organizations

이 정리된 문서는 EKS 클러스터의 비용을 효과적으로 최적화하기 위한 체계적인 접근 방법을 제공하며, DevOps 팀이 실무에서 활용할 수 있는 구체적인 가이드라인을 포함하고 있습니다.

Last updated