EKS Log Analyzer MCP Server

EKS Log Analyzer MCP Server

Enables AI assistants to analyze Amazon EKS node logs collected by the EKS Log Collector script. It provides tools and troubleshooting workflows for diagnosing issues with VPC CNI, kubelet, DNS, and general node connectivity.

Category
Visit Server

README

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

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured