Which integrations are available for this server?

Analyzes diagnostic logs and configurations from Amazon EKS nodes to troubleshoot issues with VPC CNI, kubelet, networking, and node-joining processes. Analyzes containerd logs and configuration files to identify and resolve container runtime issues on EKS nodes. Provides system-level analysis for EKS nodes by examining Linux kernel logs (dmesg), process information, and network configurations.

How do I use EKS Log Analyzer MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@EKS Log Analyzer MCP Server analyze why the node is NotReady in eks_logs.tar.gz" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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개)

도구	설명
`extract_eks_logs`	EKS log collector tar 파일 압축 해제
`list_structure`	로그 디렉토리 구조 표시
`get_node_info`	노드 기본 정보 (instance-id, region, kernel)
`analyze_vpc_cni`	VPC CNI 로그 분석 (aws-routed-eni, ipamd, CNI 설정)
`analyze_kubelet`	kubelet 로그 및 설정 분석
`analyze_containerd`	containerd 로그 및 설정 분석
`analyze_dns`	DNS 4단계 트러블슈팅
`analyze_node_join`	Node Join/NotReady 문제 분석
`analyze_networking`	네트워킹 분석 (iptables, conntrack, routes, ebpf)
`analyze_network_policy`	Network Policy eBPF 분석
`analyze_storage`	스토리지 분석 (mounts, lsblk, fstab)
`analyze_system`	시스템 분석 (ps, netstat, dmesg)
`analyze_pod_logs`	특정 Pod 로그 분석 (kube-proxy, aws-node 등)
`search_logs`	전체 로그에서 패턴 검색

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

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

가이드	URI
VPC CNI	`eks://guides/vpc-cni`
DNS	`eks://guides/dns`
Node Join	`eks://guides/node-join`
Kubelet	`eks://guides/kubelet`
Kube-proxy	`eks://guides/kube-proxy`
Containerd	`eks://guides/containerd`
Network Policy	`eks://guides/network-policy`

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

프롬프트	설명
`troubleshoot-vpc-cni`	VPC CNI 문제 분석 워크플로우
`troubleshoot-dns`	DNS 문제 분석 워크플로우
`troubleshoot-node-join`	Node Join/NotReady 분석 워크플로우
`full-diagnosis`	전체 노드 진단

사용 예시

# 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 설정