Enables management of K3s lightweight Kubernetes clusters with full support for resource operations, monitoring, and troubleshooting through AI-powered natural language commands
Provides comprehensive Kubernetes cluster management through natural language interfaces, including resource CRUD operations, monitoring, scaling, troubleshooting, and multi-cloud support for EKS, AKS, GKE, RKE2, and K3s
MCP-K8sWizard
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 Cursor AI through the Model Context Protocol:
Component Architecture
The internal architecture of MCP-K8sWizard follows a layered approach:
π οΈ 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)
- Cursor AI with MCP support
- macOS or Linux operating system
Installation
For detailed installation instructions, see our comprehensive Installation Manual.
Quick Setup:
- Clone and install
- Configure Cursor AI
Add to your
~/.cursor/mcp.json
: - 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
π Natural Language Examples
Cluster Management
Resource Operations
Debugging & Troubleshooting
Scaling & Updates
π§ 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
π€ Contributing
We welcome contributions! Please see our Contributing Guidelines for details.
Development Setup
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a pull request
Development Commands
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 Apache License 2.0 - 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
- Installation Manual - Complete setup guide for Cursor AI integration
- Configuration Guide - Advanced configuration options
- Troubleshooting Guide - Common issues and solutions
- API Reference - Complete tool documentation
Quick Links
- Getting Started: See Installation Manual for detailed setup
- Configuration: Advanced options in Configuration Guide
- Troubleshooting: Common issues in Troubleshooting Guide
π Support
- Documentation: Wiki
- Issues: GitHub Issues
- Discussions: GitHub Discussions
Made with β€οΈ for the Kubernetes community
This server cannot be installed
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.