EKS Log Analyzer MCP Server

EKS Log Analyzer MCP Server

Amazon EKS 노드 로그 분석을 위한 MCP 서버입니다.

MCP란?

Model Context Protocol (MCP)는 AI 어시스턴트가 외부 도구와 데이터에 접근할 수 있게 해주는 오픈 프로토콜입니다. Claude Desktop, Kiro, Cursor 등 MCP를 지원하는 AI 도구에서 이 서버를 연결하면, AI가 EKS 로그를 직접 분석할 수 있습니다.

목적

EKS 노드 트러블슈팅은 여러 로그 파일을 교차 분석해야 하는 복잡한 작업입니다. 이 MCP 서버는:

• EKS Log Collector로 수집한 tar 파일을 자동 분석
• VPC CNI, kubelet, DNS, Network Policy 등 주요 컴포넌트별 분석 도구 제공
• 트러블슈팅 가이드와 워크플로우를 AI에게 제공하여 체계적인 문제 진단 지원

AI 어시스턴트에게 "이 로그 분석해줘"라고 요청하면, MCP 도구를 활용해 문제를 찾아줍니다.

설치

cd eks-log-mcp
pip install -r requirements.txt

MCP 설정

.kiro/settings/mcp.json 또는 Claude Desktop 설정에 추가:

{
  "mcpServers": {
    "eks-log-analyzer": {
      "command": "python",
      "args": ["/path/to/eks-log-mcp/server.py"]
    }
  }
}

도구 목록 (14개)

트러블슈팅 가이드 (7개 Resources)

MCP Resources로 AI에게 트러블슈팅 지식을 제공합니다:

워크플로우 프롬프트 (4개 Prompts)

사용 예시

# tar 파일 압축 해제
extract_eks_logs(tar_path="eks_i-xxx.tar.gz")

# 노드 정보 확인
get_node_info(log_dir="eks_i-xxx")

# VPC CNI 분석
analyze_vpc_cni(log_dir="eks_i-xxx")

# DNS 트러블슈팅
analyze_dns(log_dir="eks_i-xxx")

# 에러 검색
search_logs(log_dir="eks_i-xxx", pattern="error")

지원하는 로그 구조

eks_i-xxx/
├── kernel/          # dmesg, uname
├── system/          # instance-id, ps, netstat
├── containerd/      # config, logs
├── storage/         # mounts, lsblk
├── var_log/
│   └── aws-routed-eni/  # VPC CNI 로그
├── networking/      # iptables, conntrack, ebpf
├── ipamd/           # ENI, pod 정보 (JSON)
├── kubelet/         # kubelet.log, kubeconfig
└── cni/             # CNI 설정