Kube

MCP Server for Kubernetes Commands processed as natural language input

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "thekaranpargaie-kube-mcp": {
      "command": "node",
      "args": [
        "server.js"
      ]
    }
  }
}

You can manage Kubernetes clusters using natural language through an MCP server that translates your commands into kubectl actions. This server gives you quick access to resources, logs, events, and common operations like scaling deployments and port-forwarding services, all through an intuitive assistant workflow.

How to use

Connect to the MCP server with an MCP-enabled client. You can then issue natural language requests to list resources, fetch details, view logs, describe components for troubleshooting, and perform operations such as port-forwarding or scaling deployments.

How to install

Prerequisites you need before starting are installed on your machine and ready to run MCP commands.

Then follow these steps to install and run the MCP server locally.

# Clone or download the MCP server project
# Replace with the exact path if you already have it
git clone https://example.com/thekaranpargaie/kube-mcp.git
cd kube-mcp

# Install dependencies
npm install

# Run tests to verify setup
node test.js

Start the server and connect a client

Start the MCP server using the standard npm script or by running the server directly. The server operates over stdio and prints a readiness message when it starts.

# Start the MCP server via npm script
npm start

# Or run directly with Node
node server.js

Available tools

list-pods

List pods in a namespace; optionally specify the namespace to narrow results.

list-services

List services in a namespace; optionally specify the namespace to narrow results.

list-deployments

List deployments in a namespace; optionally specify the namespace to narrow results.

list-namespaces

List all namespaces in the cluster.

describe-pod

Get detailed information about a specific pod; requires the pod name and may include a namespace.

get-logs

Retrieve logs from a pod; can specify the number of lines and whether to follow the log output.

port-forward

Port forward a service or pod to a local port; specify the service, local port, and target port.

scale-deployment

Scale a Deployment to a desired number of replicas within an optional namespace.

get-events

Fetch recent cluster events, optionally filtered by namespace.