Kubernetes MCP Server

The Kubernetes MCP Server is a powerful implementation of the Kubernetes model context protocol, supporting operations on Kubernetes and OpenShift clusters. It can perform various resource management tasks without relying on external tools.

Developer tools Cloud platform #Kubernetes #Cluster management #MCP protocol #Container orchestration .Go

rating : 3 points

downloads : 694

update time : 2025-04-23

What is the Kubernetes MCP Server?

The Kubernetes MCP Server is a powerful and flexible MCP server implementation for managing and operating resources in Kubernetes and OpenShift clusters.

How to use the Kubernetes MCP Server?

You can quickly start and use the server through a simple command - line tool without additional dependencies.

Applicable scenarios

Suitable for developers and operations teams who need to efficiently manage and operate Kubernetes/OpenShift clusters.

Main features

Automatically detect configuration changesMonitor Kubernetes configuration changes in real - time and automatically update the MCP server.

Support multiple resource operationsSupport CRUD operations on any Kubernetes/OpenShift resources.

Pod managementPerform operations such as listing, getting, deleting, viewing logs, and executing commands for Pods.

Event monitoringView events in all namespaces or specific namespaces within the cluster.

Namespace managementList all namespaces in the current cluster.

Project managementList OpenShift projects.

Advantages and limitations

Advantages

No additional dependencies, ready to use out - of - the - box

Support operations on any Kubernetes/OpenShift resources

Monitor configuration changes in real - time

Limitations

Higher - performance hardware support may be required for large - scale clusters

Some advanced features require users to have a certain technical background

How to use

Install the MCP Server

Quickly install the Kubernetes MCP Server via npx.

Connect to the Kubernetes cluster

Ensure that the Kubernetes environment is correctly configured.

Start using

Run the MCP Server and try to execute some basic commands.

Usage examples

Diagnose and fix an OpenShift DeploymentDemonstrate how to use the Kubernetes MCP Server to automatically diagnose and fix an OpenShift deployment.

Deploy a simple game to OpenShiftShow how to deploy a simple game to OpenShift through VS Code and the Podman MCP Server.

Frequently Asked Questions

Does the Kubernetes MCP Server require additional tools to be installed?

How to view the current Kubernetes configuration?

Related resources

Official documentation

Detailed user guides and technical documentation.

Claude Desktop integration

Integrate the Kubernetes MCP Server in Claude Desktop.

Open - source code repository

Source code repository on GitHub.

🚀 Kubernetes Model Context Protocol (MCP)

This project provides a Model Context Protocol (MCP) for Kubernetes, enabling users to manage and interact with Kubernetes resources more effectively.

🚀 Quick Start

📦 Installation

To use the MCP feature in Kubernetes, you need to install and run an MCP agent first. Here are the example commands to set up the MCP agent:

# Download the MCP agent
wget https://github.com/ModelMesh/mesh-mcp/raw/main/deploy/mcp-agent.yaml
# Deploy the MCP agent to the Kubernetes cluster
kubectl apply -f mcp-agent.yaml

💻 Usage Examples

Basic Usage

MCP provides a command-line tool mcpctl for interacting with the Kubernetes cluster. Here are some commonly used commands:

# Get the version information of the MCP agent
mcpctl version

# Check the status of the MCP agent
mcpctl status

# Get the help documentation of the MCP agent
mcpctl help

Advanced Usage

mcpctl offers various functions to interact with Kubernetes resources, including:

context create_or_update: Create or update Kubernetes resources
context delete: Delete Kubernetes resources
context get: Get information about Kubernetes resources
context list: List Kubernetes resources

Example: Create a Deployment

# Create a Deployment using a YAML file
mcpctl context create_or_update \
  --api-version apps/v1 \
  --kind Deployment \
  --name my-deployment \
  --namespace default \
  --resource ./my-deployment.yaml

Example: Delete a Service

# Delete a Service named my-service
mcpctl context delete \
  --api-version v1 \
  --kind Service \
  --name my-service \
  --namespace default

🔧 Development

If you want to develop your own MCP agent, you can use the following commands:

# Compile the project
make build

# Run the MCP agent and use it with the mcp-inspector tool
npx @modelcontextprotocol/inspector@latest $(pwd)/kubernetes-mcp-server

This documentation introduces how to install, configure, and use the Kubernetes Model Context Protocol (MCP) agent, as well as how to interact with MCP resources.