mcp-k8s-eye

mcp-k8s-eye

Kubernetes management and diagnostics tool with MCP protocol support.

26
Stars
9
Forks
26
Watchers
1
Issues
mcp-k8s-eye enables users to manage and analyze Kubernetes clusters using standardized Model Context Protocol (MCP) interfaces. It offers comprehensive resource operations, diagnostics, and resource usage monitoring through both stdio and SSE transports. Supporting generic and custom resource management along with advanced diagnostic tooling, it is geared for integration with AI clients and other MCP consumers.

Key Features

Standardized MCP protocol support (stdio, SSE)
Management of generic and custom Kubernetes resources
Pod and deployment operations (exec, logs, scaling)
Detailed resource listing, creation, updating, and deletion
Comprehensive diagnostics for pods, services, deployments, nodes, and more
Workload resource usage monitoring (CPU, memory)
Multiple AI client support
Advanced analysis of networking and webhook configurations
Cluster-wide resource and utilization diagnostics
Customizable integration via environment and protocol configuration

Use Cases

Automated Kubernetes cluster management for platform teams
Operational diagnostics for troubleshooting Kubernetes workloads
Monitoring resource utilization at granular and cluster-wide levels
Integration into AI-powered DevOps assistants or chat agents
Custom resource definition (CRD) operations in managed environments
Real-time cluster health and status analysis
Infrastructure as Code (IaC) workflows for resource deployment and updates
Network policy and webhook configuration audits
Analysis of cluster resource constraints and bottlenecks
Cluster administration through standardized context protocols

README

mcp-k8s-eye

mcp-k8s-eye is a tool that can manage kubernetes cluster and analyze workload status.

Features

Core Kubernetes Operations

  • Connect to a Kubernetes cluster
  • Generic Kubernetes Resources management capabilities
    • Support all navtie resources: Pod, Deployment, Service, StatefulSet, Ingress...
    • Support CustomResourceDefinition resources
    • Operations include: list, get, create, update, delete
  • Pod management capabilities (exec, logs)
  • Deployment management capabilities (scale)
  • Describe Kubernetes resources
  • Explain Kubernetes resources

Diagnostics

  • Pod diagnostics (analyze pod status, container status, pod resource utilization)
  • Service diagnostics (analyze service selector configuration, not ready endpoints, events)
  • Deployment diagnostics (analyze available replicas)
  • StatefulSet diagnostics (analyze statefulset service if exists, pvc if exists, available replicas)
  • CronJob diagnostics (analyze cronjob schedule, starting deadline, last schedule time)
  • Ingress diagnostics (analyze ingress class configuration, related services, tls secrets)
  • NetworkPolicy diagnostics (analyze networkpolicy configuration, affected pods)
  • ValidatingWebhook diagnostics (analyze webhook configuration, referenced services and pods)
  • MutatingWebhook diagnostics (analyze webhook configuration, referenced services and pods)
  • Node diagnostics (analyze node conditions)
  • Cluster diagnostics and troubleshooting

Monitoring

  • Pod, Deployment, ReplicaSet, StatefulSet, DaemonSet workload resource usage (cpu, memory)
  • Node capacity, utilization (cpu, memory)
  • Cluster capacity, utilization (cpu, memory)

Advanced Features

  • Multiple transport protocols support (Stdio, SSE)
  • Support multiple AI Clients

Tools Usage

Resource Operation Tools

  • resource_get: Get detailed resource information about a specific resource in a namespace
  • resource_list: List detailed resource information about all resources in a namespace
  • resource_create_or_update: Create or update a resource in a namespace
  • resource_delete: Delete a resource in a namespace
  • resource_describe: Describe a resource detailed information in a namespace
  • deployment_scale: Scale a deployment in a namespace
  • pod_exec: Execute a command in a pod in a namespace`
  • pod_logs: Get logs from a pod in a namespace

Diagnostics Tools

  • pod_analyze: Diagnose all pods in a namespace
  • deployment_analyze: Diagnose all deployments in a namespace
  • statefulset_analyze: Diagnose all statefulsets in a namespace
  • service_analyze: Diagnose all services in a namespace
  • cronjob_analyze: Diagnose all cronjobs in a namespace
  • ingress_analyze: Diagnose all ingresses in a namespace
  • networkpolicy_analyze: Diagnose all networkpolicies in a namespace
  • validatingwebhook_analyze: Diagnose all validatingwebhooks
  • mutatingwebhook_analyze: Diagnose all mutatingwebhooks
  • node_analyze: Diagnose all nodes in cluster

Monitoring Tools

  • workload_resource_usage: Get pod/deployment/replicaset/statefulset resource usage in a namepace (cpu, memory)

Requirements

  • Go 1.23 or higher
  • kubectl configured

Installation

# clone the repository
git clone https://github.com/wenhuwang/mcp-k8s-eye.git
cd mcp-k8s-eye

# build the binary
go build -o mcp-k8s-eye

Usage

Stdio mode

{
  "mcpServers": {
    "k8s eye": {
      "command": "YOUR mcp-k8s-eye PATH",
      "env": {
        "HOME": "USER HOME DIR"
      },
    }
  }
}

env.HOME is used to set the HOME directory for kubeconfig file.

SSE mode

  1. start your mcp sse server
  2. config your mcp server
{
  "mcpServers": {
    "k8s eye": {
      "url": "http://localhost:8080/sse",
      "env": {}
    }
  }
}

cursor tools

cursor tools

Star History

Star History Chart

Repository Owner

wenhuwang
wenhuwang

User

Repository Details

Language Go
Default Branch main
Size 389 KB
Contributors 1
License Apache License 2.0
MCP Verified Nov 11, 2025

Programming Languages

Go
100%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Inspektor Gadget MCP Server

    Inspektor Gadget MCP Server

    AI-powered Kubernetes troubleshooting via Model Context Protocol.

    Inspektor Gadget MCP Server provides an AI-powered debugging and inspection interface for Kubernetes clusters. Leveraging the Model Context Protocol, it enables intelligent output summarization, one-click deployment of Inspektor Gadget, and automated discovery of debugging tools from Artifact Hub. The server integrates seamlessly with VS Code for interactive AI commands, simplifying Kubernetes troubleshooting and monitoring workflows.

    • 16
    • MCP
    • inspektor-gadget/ig-mcp-server
  • metoro-mcp-server

    metoro-mcp-server

    Bridge Kubernetes observability data to LLMs via the Model Context Protocol.

    Metoro MCP Server is an implementation of the Model Context Protocol (MCP) that enables seamless integration between Kubernetes observability data and large language models. It connects Metoro’s eBPF-based telemetry APIs to LLM applications such as the Claude Desktop App, allowing AI systems to query and analyze Kubernetes clusters. This solution supports both authenticated and demo modes for accessing real-time cluster insights.

    • 45
    • MCP
    • metoro-io/metoro-mcp-server
  • RAD Security MCP Server

    RAD Security MCP Server

    AI-powered security insights for Kubernetes and cloud environments via the Model Context Protocol.

    RAD Security MCP Server is an implementation of the Model Context Protocol designed to deliver AI-powered security insights and operations for Kubernetes and cloud platforms. It serves as an MCP server for RAD Security, providing a range of toolkits for container, cluster, identity, audit, and threat management. The server is easily configurable via environment variables, allowing for flexible toolkit activation and authentication options. Multiple deployment options are supported, including Node.js, Docker, and integration with development environments like Cursor IDE and Claude Desktop.

    • 5
    • MCP
    • rad-security/mcp-server
  • kibitz

    kibitz

    The coding agent for professionals with MCP integration.

    kibitz is a coding agent that supports advanced AI collaboration by enabling seamless integration with Model Context Protocol (MCP) servers via WebSockets. It allows users to configure Anthropic API keys, system prompts, and custom context providers for each project, enhancing contextual understanding for coding tasks. The platform is designed for developers and professionals seeking tailored AI-driven coding workflows and provides flexible project-specific configuration.

    • 104
    • MCP
    • nick1udwig/kibitz
  • Last9 MCP Server

    Last9 MCP Server

    Enables AI agents to access real-time production observability data for automated code fixes.

    Last9 MCP Server is an implementation of the Model Context Protocol (MCP) designed to provide seamless integration between AI agents and production observability data. It allows tools and agents to fetch live logs, metrics, traces, events, and alerts from Last9 systems, supporting a range of development environments and IDEs. This enables faster debugging, automated code fixes, and insightful context directly within local development workflows.

    • 46
    • MCP
    • last9/last9-mcp-server
  • Druid MCP Server

    Druid MCP Server

    Comprehensive Model Context Protocol server for advanced Apache Druid management and analytics

    Druid MCP Server provides a fully MCP-compliant interface for managing, analyzing, and interacting with Apache Druid clusters. Leveraging tools, resources, and AI-assisted prompts, it enables LLM clients and AI agents to perform operations such as time series analysis, statistical exploration, and data management through standardized protocols. The server is built with a feature-based architecture, offers real-time communication via multiple transports, and includes automatic discovery and registration of MCP components.

    • 9
    • MCP
    • iunera/druid-mcp-server
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results