EKS Model Context Protocol (MCP) Server

Name: EKS Model Context Protocol (MCP) Server
Author: mahmoudsalah84

@mahmoudsalah84

Repository

About EKS Model Context Protocol (MCP) Server

No overview available yet

#eks-mcp-server #eks #mcp #kubernetes #genai

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "eks-mcp-server-new": {
      "command": "python",
      "args": [
        "main.py"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is EKS Model Context Protocol (MCP) Server?

A lightweight server implementing the Model Context Protocol for EKS operations, providing a standardized interface for GenAI agents to interact with EKS clusters. It includes comprehensive EKS and Kubernetes resource management capabilities.

How to use EKS Model Context Protocol (MCP) Server?

Run locally with Python (pip install -r requirements.txt, then python main.py) or with Docker (docker build -t eks-mcp-server . && docker run -d -p 8000:8000 --name mcp-server eks-mcp-server). Docker Compose (docker-compose up -d) and ECS deployment scripts are also provided. Tests are available via test_*.py scripts.

Key features of EKS Model Context Protocol (MCP) Server

Fast response times with proper timeout handling
Comprehensive EKS and Kubernetes operations support
Multiple authentication methods for EKS clusters
Robust error handling and detailed logging
Docker containerization for easy deployment
ECS deployment support with client using Amazon Bedrock

Use cases of EKS Model Context Protocol (MCP) Server

GenAI agents listing EKS clusters and describing nodegroups
Retrieving pod logs, deployments, and services from a cluster
Managing Kubernetes resources across namespaces
Automating cluster inspection and troubleshooting via MCP

FAQ from EKS Model Context Protocol (MCP) Server

What operations does the server support?

It supports EKS operations (list/describe clusters, nodegroups) and Kubernetes operations (list pods, deployments, services, get pod logs, etc.) via POST to /mcp/v1/query.

How does authentication work?

The server supports AWS SDK authentication, kubectl with generated kubeconfig, and direct Kubernetes API calls. The current implementation uses the kubectl method.

What are the prerequisites?

Docker (for containerized deployment) or Python 3.8+ (for local development), AWS credentials for production use, and ECS task role added to the EKS cluster’s aws-auth ConfigMap when deployed on ECS.