MCP 服务器

Kubernetes MCP Server

Enables real-time Kubernetes cluster observability and debugging through standardized MCP interface. Provides access to pods, services, nodes, events, and includes built-in tools for cluster health analysis and issue identification.

README

Kubernetes MCP Server - Production Ready

A production-ready Model Context Protocol (MCP) server for Kubernetes observability and debugging.

🚀 What This Provides

MCP Server: Standardized interface for Kubernetes cluster access
Real-time Data: Live access to pods, services, nodes, and events
Debugging Tools: Built-in tools for cluster health and issue analysis
Production Ready: Clean, tested code ready for production use

📋 Prerequisites

Kubernetes cluster (local or remote)
kubectl configured and working
Python 3.11+
pip package manager

🛠️ Quick Setup

1. Clone the Repository

git clone https://github.com/vivekbala/mcp.git
cd mcp

2. Install Dependencies

python3.11 -m pip install -r requirements.txt

3. Verify Setup

python3.11 verify_setup.py

🔧 MCP Server Features

Resources Available

k8s://pods - All pods with status and details
k8s://services - Services with endpoints and connectivity info
k8s://nodes - Node health and capacity info
k8s://events - Recent cluster events for troubleshooting
k8s://deployments - Deployment status and replica info

Tools Available

cluster_health_check - Comprehensive health analysis
check_pod_status - Pod status and issue identification
analyze_service_connectivity - Service endpoint analysis
get_pod_logs - Log retrieval and analysis

📱 Usage Examples

Basic Demo

python3.11 demo_script.py

Debugging Demo

python3.11 debug_demo.py

Run MCP Server

python3.11 mcp_server.py

🔗 Integration Options

Claude Desktop

{
  "mcpServers": {
    "kubernetes-observability": {
      "command": "python3.11",
      "args": ["/path/to/mcp_server.py"],
      "env": {
        "KUBECONFIG": "/path/to/kubeconfig"
      }
    }
  }
}