k8s-mcp-server

k8s-mcp-server

1
cloud_platformsdeveloper_tools

The project is a backend system designed to facilitate the management of Kubernetes resources and logs using the Model Context Protocol (MCP). It enables CRUD operations, log retrieval, and extensive formatting options for export.

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