https://github.com/Flux159/mcp-server-kubernetes

https://github.com/Flux159/mcp-server-kubernetes

Last synced: about 2 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/Flux159/mcp-server-kubernetes
• Owner: Flux159
• License: mit
• Created: 2024-12-08T00:01:28.000Z (about 2 months ago)
• Default Branch: main
• Last Pushed: 2024-12-08T05:30:14.000Z (about 2 months ago)
• Last Synced: 2024-12-08T06:21:30.690Z (about 2 months ago)
• Language: JavaScript
• Size: 47.9 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-mcp-servers - Kubernetes - Connect to Kubernetes cluster and manage pods, deployments, services. (Community Servers)
• awesome-mcp-servers - Kubernetes - Connect to Kubernetes cluster and manage pods, deployments, services. (Community Servers)

README

        
# mcp-server-kubernetes

MCP Server that can connect to a Kubernetes cluster and manage it.

https://github.com/user-attachments/assets/f25f8f4e-4d04-479b-9ae0-5dac452dd2ed

## Usage with Claude Desktop

```json

{

  "mcpServers": {

    "kubernetes": {

      "command": "npx",

      "args": ["mcp-server-kubernetes"]

    }

  }

}

```

The server will automatically connect to your current kubectl context. Make sure you have:

1. kubectl installed and in your PATH

2. A valid kubeconfig file with contexts configured

3. Access to a Kubernetes cluster configured for kubectl (e.g. minikube, Rancher Desktop, GKE, etc.)

You can verify your connection by asking Claude to list your pods or create a test deployment.

If you have errors, open up a standard terminal and run `kubectl get pods` to see if you can connect to your cluster without credentials issues.

## Features

- [x] Connect to a Kubernetes cluster

- [x] List all pods

- [x] List all services

- [x] List all deployments

- [x] Create a pod

- [x] Delete a pod

- [x] List all namespaces

- [] Port forward to a pod

- [] Get logs from a pod for debugging

- [] Choose namespace for next commands (memory)

- [] Support Helm for installing charts

## Development & Testing

```bash

git clone https://github.com/Flux159/mcp-server-kubernetes.git

cd mcp-server-kubernetes

bun install

bun run test

```

## Not planned

Authentication / adding clusters to kubectx.