MCP Server on EKS

by jbrcoleman

316 downloads
Not rated
GitHub

About

This project deploys a Model Context Protocol (MCP) server on Amazon EKS using Terraform for infrastructure management. It provides natural-language and programmatic access to Kubernetes cluster operations, targeting developers and platform teams who manage AWS EKS clusters.

Details

Author
jbrcoleman
Downloads
316
Categories
Other

- Real Kubernetes API integration with actual EKS clusters
- Live cluster information with namespace counts and node status
- Tools: get_cluster_status, list_pods, get_deployments
- Health checks with liveness and readiness probes
- Supports both in-cluster and local kubectl configurations
- Claude Desktop and programmatic Python client integration

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP Server on EKS
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Deploy via the provided scripts in phases (infrastructure, Karpenter, app) or all at once using ./scripts/deploy.sh all. For legacy deployment without Karpenter, use make init plan apply then make deploy. Local testing is possible with python server-enhanced.py after installing dependencies. Integrate with Claude Desktop by copying the claude-desktop-config.json to the appropriate configuration path.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp server on eks": {
            "mcp-server-eks-jbrcoleman": {
                "command": "python",
                "args": [
                    "server-enhanced.py"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-server-eks-jbrcoleman": {
        "command": "python",
        "args": [
            "server-enhanced.py"
        ]
    }
}

MCP Server on EKS

This project deploys a Model Context Protocol (MCP) server on Amazon EKS using Terraform for infrastructure management.

Architecture

- MCP Server: Python-based server implementing MCP protocol
- Container: Docker container for the MCP server
- Kubernetes: EKS cluster for container orchestration
- Karpenter: Kubernetes-native node autoscaler for efficient scaling
- Infrastructure: Terraform for AWS resource management

Prerequisites

- AWS CLI configured with appropriate permissions
- Docker installed
- Terraform >= 1.0
- kubectl installed
- An AWS account with ECR repository created

Quick Start

1. Set environment variables:

export AWS_REGION=us-east-1
export AWS_ACCOUNT_ID=your-account-id
export CLUSTER_NAME=mcp-eks-cluster

2. Deploy with Karpenter (Recommended):
```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.