Skip to main content
Glama

MCP-K8sWizard

by heniv96
GitHub
Go
MIT License
3
  • Apple
  • Linux
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MCP-K8sWizard

License Go Version Kubernetes MCP Makefile Stars Issues PRs Welcome Last Commit

The Kubernetes Wizard for Modern DevOps
Streamline your Kubernetes operations with AI-powered natural language interfaces and comprehensive DevOps automation.

๐Ÿš€ Overview

MCP-K8sWizard is a comprehensive Model Context Protocol (MCP) solution designed for professional DevOps teams. It provides natural language interfaces for complex Kubernetes workflows, enabling teams to manage clusters, monitor applications, and execute operational tasks efficiently through AI-powered conversations.

โœจ Key Features

๐ŸŽฏ Multi-Cloud Kubernetes Management

  • Universal Compatibility: Native support for EKS, AKS, GKE, RKE2, K3s, and standard Kubernetes distributions

  • Intelligent Cluster Detection: Automatic identification and configuration of cluster types and capabilities

  • Advanced Resource Management: Comprehensive CRUD operations across all Kubernetes resource types

  • Real-time Monitoring: Live cluster health, resource utilization, and performance metrics

๐Ÿค– AI-Powered Operations

  • Natural Language Processing: Conversational interface for complex DevOps operations

  • Intelligent Troubleshooting: AI-driven diagnostics and step-by-step resolution guidance

  • Smart Prompts: Context-aware prompt suggestions for different scenarios

  • Automated Insights: Proactive identification of potential issues and optimization opportunities

๐Ÿ”’ Security & Access Control

  • RBAC Integration: Full integration with Kubernetes RBAC and identity providers

  • Audit Logging: Comprehensive audit trails for all operations and access

  • Secure Communication: TLS encryption for all communications

  • Minimal Privilege: Secure by design with least privilege access patterns

๐Ÿ—๏ธ Architecture

MCP Protocol Integration

The following diagram shows how MCP-K8sWizard integrates with VSCode/Cursor AI through the Model Context Protocol:

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Cursor AI โ”‚โ”€โ”€โ”€โ–ถโ”‚ MCP Protocol โ”‚โ”€โ”€โ”€โ–ถโ”‚ MCP-K8sWizard โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ Server โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ โ”‚ โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Kubernetes โ”‚ โ”‚ Context โ”‚ โ”‚ Tool Handlers โ”‚ โ”‚ API โ”‚ โ”‚ Manager โ”‚ โ”‚ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”‚ โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ โ”‚ โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ K8s Tools โ”‚ โ”‚ Kubectl Tools โ”‚ โ”‚ Prompt Tools โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ€ข Cluster Infoโ”‚ โ”‚ โ€ข Resource โ”‚ โ”‚ โ€ข Diagnostics โ”‚ โ”‚ โ€ข Resources โ”‚ โ”‚ CRUD โ”‚ โ”‚ โ€ข Troubleshootโ”‚ โ”‚ โ€ข Logs/Events โ”‚ โ”‚ โ€ข Scaling โ”‚ โ”‚ โ€ข Optimizationโ”‚ โ”‚ โ€ข Pod Exec โ”‚ โ”‚ โ€ข Rollouts โ”‚ โ”‚ โ€ข Security โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

Component Architecture

The internal architecture of MCP-K8sWizard follows a layered approach:

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ MCP Layer โ”‚ โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค โ”‚ MCP Server โ”€โ”€โ–ถ Tool Registry โ”€โ”€โ–ถ Request Router โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Core Services โ”‚ โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค โ”‚ Context Manager โ”€โ”€โ–ถ K8s Client Manager โ”€โ”€โ–ถ Resource Handler โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”‚ โ”‚ โ”‚ Config Manager โ”€โ”€โ–ถ Event Monitor โ”€โ”€โ–ถ Kubernetes API โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Tool Handlers โ”‚ โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค โ”‚ K8s Tools โ”‚ Kubectl Tools โ”‚ Prompt Tools โ”‚ Context Tools โ”‚ โ”‚ โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ โ”‚ โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ โ”‚ โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ โ”‚ โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ โ”‚ โ”‚ โ€ข Cluster Ops โ”‚ โ€ข Resource Mgmt โ”‚ โ€ข AI Guidance โ”‚ โ€ข Multi-Clusterโ”‚ โ”‚ โ€ข Monitoring โ”‚ โ€ข CRUD Ops โ”‚ โ€ข Diagnostics โ”‚ โ€ข Context Sw. โ”‚ โ”‚ โ€ข Debugging โ”‚ โ€ข Scaling โ”‚ โ€ข Optimization โ”‚ โ€ข Health Chk โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐Ÿ› ๏ธ Available Tools

Kubernetes Management Tools (37 Total)

Category

Tools

Description

Kubernetes Operations (14)

k8s_cluster_info

,

k8s_check_all_clusters

,

ping

,

k8s_list_resources

,

k8s_get_resource

,

k8s_get_logs

,

k8s_get_events

,

k8s_exec_in_pod

,

k8s_natural_language_query

Direct Kubernetes API operations, monitoring, and debugging

Kubectl Operations (12)

kubectl_get

,

kubectl_describe

,

kubectl_create

,

kubectl_apply

,

kubectl_delete

,

kubectl_context

,

kubectl_scale

,

kubectl_patch

,

kubectl_rollout

,

kubectl_generic

,

explain_resource

,

list_api_resources

Full CRUD operations, scaling, rollouts, and resource management via kubectl

Context Management (4)

k8s_set_context

,

k8s_get_current_context

,

k8s_list_contexts

,

k8s_clear_context

Multi-cluster context switching and management

AI-Powered Guidance (7)

k8s_diagnose

,

k8s_troubleshoot

,

k8s_optimize

,

k8s_security

,

k8s_performance

,

k8s_deployment

,

prompt_suggestions

Intelligent diagnostic, optimization, and troubleshooting prompts

๐Ÿš€ Quick Start

Prerequisites

  • Go 1.25.1 or later

  • Kubernetes cluster access (kubeconfig configured)

  • VSCode/Cursor AI with MCP support

  • macOS or Linux operating system

Installation

For detailed installation instructions, see our comprehensive Installation Manual.

Quick Setup:

  1. Clone and install

    git clone https://github.com/your-org/mcp-k8swizard.git cd mcp-k8swizard make install

  2. Configure Cursor AI Add to your ~/.cursor/mcp.json:

    { "mcpServers": { "k8s-wizard": { "command": "/path/to/mcp-k8swizard", "args": ["--verbose"] } } }

  3. Restart Cursor AI and start using natural language commands!

๐Ÿ“– Need detailed instructions? Check out our Installation Manual for step-by-step setup, troubleshooting, and advanced configuration options.

Basic Usage

# Check cluster health "Show me the status of all my Kubernetes clusters" # List resources "List all pods in the production namespace" # Debug issues "Get logs from the failing pod in the web-app deployment" # Scale applications "Scale the frontend deployment to 5 replicas" # Troubleshoot problems "Help me diagnose why my pod is stuck in Pending state"

๐Ÿ“‹ Natural Language Examples

Cluster Management

"Show me all my Kubernetes clusters and their health status" "Check the resource usage across all nodes in my EKS cluster" "List all namespaces and their resource quotas"

Resource Operations

"Create a new namespace called 'staging'" "List all deployments with more than 3 replicas" "Show me the configuration of the nginx service" "Delete all pods with the label 'app=test'"

Debugging & Troubleshooting

"Get the logs from the last 100 lines of the api-server pod" "Show me events related to the failing deployment" "Execute a shell command in the debug container" "Why is my pod not starting? Help me troubleshoot"

Scaling & Updates

"Scale the web-app deployment to 10 replicas" "Roll out a new version of the frontend service" "Pause the rollout of the database deployment" "Show me the rollout history for the api service"

๐Ÿ”ง Configuration

Environment Variables

Variable

Description

Default

KUBECONFIG

Path to kubeconfig file

~/.kube/config

K8S_CONTEXT

Default Kubernetes context

Current context

LOG_LEVEL

Logging level (DEBUG, INFO, WARN, ERROR)

INFO

LOG_FILE

Log file path

stdout

Command Line Options

./mcp-k8swizard --help Options: -log-level string Set log level (DEBUG, INFO, WARN, ERROR) -verbose Enable verbose logging (equivalent to DEBUG level) -version Show version information -help Show help information

๐Ÿค Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Setup

  1. Fork the repository

  2. Create a feature branch

  3. Make your changes

  4. Submit a pull request

Development Commands

# Build the project make build # Install dependencies make deps # Format code make fmt # Run linter make lint # Run go vet make vet # Clean build artifacts make clean

Code Style

  • Follow Go standard formatting (gofmt)

  • Use meaningful variable and function names

  • Add comments for public functions

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

๐Ÿ™ Acknowledgments

  • Model Context Protocol for the MCP specification

  • Kubernetes for the amazing container orchestration platform

  • Go for the excellent programming language

  • The open-source community for inspiration and support

๐Ÿ“š Documentation

Manuals

Quick Links

๐Ÿ“ž Support

Made with โค๏ธ for the Kubernetes community

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

๐Ÿค– AI-powered Kubernetes management with 37+ tools via natural language. Transform complex Kubectl commands into simple conversations. Perfect for DevOps teams using Cursor AI. Built with Go.

  1. ๐Ÿš€ Overview
    1. โœจ Key Features
      1. ๐ŸŽฏ Multi-Cloud Kubernetes Management
      2. ๐Ÿค– AI-Powered Operations
      3. ๐Ÿ”’ Security & Access Control
    2. ๐Ÿ—๏ธ Architecture
      1. MCP Protocol Integration
      2. Component Architecture
    3. ๐Ÿ› ๏ธ Available Tools
      1. Kubernetes Management Tools (37 Total)
    4. ๐Ÿš€ Quick Start
      1. Prerequisites
      2. Installation
      3. Basic Usage
    5. ๐Ÿ“‹ Natural Language Examples
      1. Cluster Management
      2. Resource Operations
      3. Debugging & Troubleshooting
      4. Scaling & Updates
    6. ๐Ÿ”ง Configuration
      1. Environment Variables
      2. Command Line Options
    7. ๐Ÿค Contributing
      1. Development Setup
      2. Development Commands
      3. Code Style
    8. ๐Ÿ“„ License
      1. ๐Ÿ™ Acknowledgments
        1. ๐Ÿ“š Documentation
          1. Manuals
          2. Quick Links
        2. ๐Ÿ“ž Support

          Appeared in Searches

          New MCP Servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/heniv96/MCP-K8sWizard'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server