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