kubectl-go-mcp-server

A Model Context Protocol (MCP) server that provides Kubernetes cluster interaction capabilities through kubectl commands. This server enables MCP-compatible clients (like VS Code with Copilot) to execute kubectl commands and retrieve Kubernetes cluster information safely and securely.

Features

• Kubernetes Integration: Execute kubectl commands through MCP interface
• Interactive Command Protection: Prevents execution of interactive commands that could hang
• Resource Modification Detection: Identifies commands that modify cluster resources
• Robust Security: Multiple validation layers to prevent command injection and unsafe operations
• Configurable Kubeconfig: Support for custom kubeconfig paths
• Standard Go Project Layout: Following Go best practices for maintainability
• Cobra CLI Integration: Professional command-line interface with subcommands

Architecture

kubectl-go-mcp-server acts as a bridge between MCP clients (like VS Code with Copilot) and Kubernetes clusters through kubectl commands:

VS Code/Copilot → MCP Client → kubectl-go-mcp-server → kubectl → Kubernetes Cluster

Key Components

• MCP Server: Handles JSON-RPC communication and tool registration
• kubectl Tool: Validates and executes kubectl commands safely
• Security Layer: Prevents interactive commands and command injection

For detailed architecture information, see docs/architecture.md.

pkg/
├── types/          # 🔧 Core interfaces and data structures
│   ├── Tool        # Interface for all MCP tools
│   ├── Schema      # JSON schema definitions
│   └── ExecResult  # Command execution results
│
├── kubectl/        # 🎯 kubectl-specific implementation
│   ├── KubectlTool # Main tool implementation
│   ├── Validation  # Command safety checks
│   └── Execution   # kubectl command runner
│
internal/
├── mcp/           # 🌐 MCP protocol implementation
│   ├── Server     # MCP server and protocol handling
│   ├── Tools      # Tool registry and management
│   └── Protocol   # JSON-RPC message handling
│
└── config/        # ⚙️ Configuration management
    ├── Config     # Application configuration
    └── Defaults   # Default settings

Extension Points

The architecture is designed for extensibility:

1. New Tools: Implement the Tool interface to add new capabilities
2. Custom Validation: Add validation layers for specific use cases
3. Protocol Extensions: Extend MCP handling for additional features
4. Output Formatters: Add custom result processing

Performance Considerations

• Concurrent Safety: All components are designed for concurrent access
• Resource Management: Proper cleanup and resource disposal
• Timeout Handling: Configurable timeouts for all operations
• Memory Efficiency: Streaming and buffered I/O for large outputs

Installation

Prerequisites

• Go 1.23 or later
• kubectl installed and configured
• Access to a Kubernetes cluster

Build from Source

# Clone the repository
git clone https://github.com/Joelayo/kubectl-go-mcp-server.git
cd kubectl-go-mcp-server

# Build the binary
make build

# Or install directly
make install

Download Binary

Download the latest release from the releases page for your platform.

Usage

Standalone

# Run with default kubeconfig
./kubectl-go-mcp-server

# Run with custom kubeconfig
./kubectl-go-mcp-server --kubeconfig /path/to/kubeconfig

# Show version
./kubectl-go-mcp-server version

VS Code Integration

To use with VS Code and Copilot, add this MCP server to your VS Code settings:

{
  "mcp": {
    "servers": {
      "kubectl-go-mcp-server": {
        "type": "stdio",
        "command": "/path/to/kubectl-go-mcp-server",

... [View full README on GitHub](https://github.com/Joelayo/kubectl-go-mcp-server#readme)