k8s-mcp-server

k8s-mcp-server

3.2

If you are the rightful owner of k8s-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A backend system that provides an interactive and extensible interface for managing Kubernetes resources, retrieving and analyzing logs, and formatting logs for export through the Model Context Protocol (MCP).

Kubernetes MCP Server

A backend system that provides an interactive and extensible interface for managing Kubernetes resources, retrieving and analyzing logs, and formatting logs for export through the Model Context Protocol (MCP).

Features

  • CRUD operations on Kubernetes resources (Pods, Services, Namespaces, Deployments, etc.)
  • Log retrieval and pattern searching
  • Log formatting and exporting in multiple formats (Plaintext, JSON, CSV, NDJSON)
  • Extensible architecture for future enhancements

Requirements

  • Go 1.24+
  • Kubernetes cluster access
  • kubectl configured

Installation

# Clone the repository
git clone https://github.com/mayukhsarkar/k8s-mcp-server.git
cd k8s-mcp-server

# Build the binary
go build -o k8s-mcp-server

# Run the server
./k8s-mcp-server serve

Usage

# Start the MCP server
./k8s-mcp-server serve

# Get help
./k8s-mcp-server --help

API Documentation

The MCP server exposes HTTP endpoints for interacting with Kubernetes resources and logs.

Kubernetes Operations

  • POST /api/v1/resources/{resource_type} - Create a resource
  • GET /api/v1/resources/{resource_type} - List resources
  • GET /api/v1/resources/{resource_type}/{name} - Get resource details
  • DELETE /api/v1/resources/{resource_type}/{name} - Delete a resource

Log Operations

  • GET /api/v1/logs/{namespace}/{pod} - Get logs from a pod
  • GET /api/v1/logs/search - Search logs with pattern matching
  • GET /api/v1/logs/export - Export logs in various formats

License

MIT