<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="500" zoomAndPan="magnify" viewBox="0 0 375 374.999991" height="500" preserveAspectRatio="xMidYMid meet" version="1.0"><path fill="#ffffff" d="M 176.261719 185.164062 L 170.148438 223.289062 L 203.796875 223.289062 L 196.632812 185.164062 L 176.261719 185.164062 " fill-opacity="1" fill-rule="nonzero"/><path fill="#4c44cb" d="M 176.261719 185.164062 L 175.214844 184.996094 L 169.101562 223.121094 C 169.054688 223.425781 169.140625 223.738281 169.34375 223.972656 C 169.542969 224.210938 169.835938 224.347656 170.148438 224.347656 L 203.796875 224.347656 C 204.113281 224.347656 204.410156 224.207031 204.613281 223.960938 C 204.8125 223.722656 204.894531 223.402344 204.839844 223.089844 L 197.675781 184.96875 C 197.578125 184.46875 197.140625 184.105469 196.632812 184.105469 L 176.261719 184.105469 C 175.742188 184.105469 175.296875 184.484375 175.214844 184.996094 L 176.261719 185.164062 L 176.261719 186.222656 L 195.753906 186.222656 L 202.523438 222.230469 L 171.390625 222.230469 L 177.304688 185.332031 L 176.261719 185.164062 L 176.261719 186.222656 L 176.261719 185.164062 " fill-opacity="1" fill-rule="nonzero"/><path fill="#ffffff" d="M 180.769531 185.164062 L 177.230469 223.289062 L 196.71875 223.289062 L 192.566406 185.164062 L 180.769531 185.164062 " fill-opacity="1" fill-rule="nonzero"/><path fill="#4c44cb" d="M 180.769531 185.164062 L 179.71875 185.066406 L 176.175781 223.191406 C 176.152344 223.488281 176.246094 223.78125 176.449219 224 C 176.648438 224.21875 176.929688 224.347656 177.230469 224.347656 L 196.71875 224.347656 C 197.019531 224.347656 197.304688 224.21875 197.503906 223.996094 C 197.707031 223.769531 197.800781 223.472656 197.769531 223.171875 L 193.621094 185.050781 C 193.5625 184.515625 193.105469 184.105469 192.566406 184.105469 L 180.769531 184.105469 C
Claude Kubernetes MCP Server
This repository contains the Claude Kubernetes MCP (Model Context Protocol) server, built in Go. The server integrates with ArgoCD, GitLab, Claude AI, and Kubernetes to enable advanced control and automation of Kubernetes environments.
[See Our Documentation Here](https://kubernetes-mcp-server.dropasite.com/)
Table of Contents
- [Overview](#overview)
- [Prerequisites](#prerequisites)
- [Setup Instructions](#setup-instructions)
- [Configuration](#configuration)
- [Running Locally](#running-locally)
- [Building and Running with Docker](#building-and-running-with-docker)
- [Production Deployment](#production-deployment)
- [API Documentation](#api-documentation)
- [Postman Collection](#postman-collection)
- [License](#license)
Overview
This server is designed to orchestrate Kubernetes workloads using Claude AI, GitLab, ArgoCD, and Vault. It exposes a REST API that allows programmatic interaction with these systems, driven by a configured `config.yaml` and authenticated using an API key.
Prerequisites
- Go 1.20+
- Docker
- Kubernetes cluster & valid `~/.kube/config`
- EKS cluster with AWS_PROFILE set locally
- ArgoCD credentials
- GitLab personal access token
- Claude API key (Anthropic)
- Vault credentials (optional, depending on use)
Setup Instructions
1. Clone the Repository
2. Export Required Environment Variables
Export credentials for ArgoCD, GitLab, and Claude:
Ensure a kubeconfig is available:
3. Configure `config.yaml`
Update `kubernetes-claude-mcp/config.yaml` with credentials and server preferences:
You can use the provided Go templates or environment variable interpolation method.
4. Add API Key for Postman
Please ensure a `config.yaml` includes an `apiKey`. This will be used to authenticate requests in Postman or any external client.
Running Locally
With Debug Logging:
Server will start and bind to the configured port in `config.yaml` (default: 8080).
Building and Running with Docker
1. Build the Image
2. Run the Container (second build option included)
Production Deployment
A Helm chart is included in the repository for Kubernetes deployment:
1. Navigate to the Helm Chart Directory
2. Deploy with Helm
Update `values.yaml` with appropriate values and run:
To upgrade:
Please ensure secrets and config maps are properly mounted and secured in the cluster.
API Documentation
Below are the primary endpoints exposed by the MCP server. All requests require the `X-API-Key` header:
General
- **Health Check** - `GET /api/v1/health`
Kubernetes
- **List Namespaces** - `GET /api/v1/namespaces`
- **List Resources** - `GET /api/v1/resources/{kind}?namespace={ns}`
- **Get Specific Resource** - `GET /api/v1/resources/{kind}/{name}?namespace={ns}`
- **Get Events for a Resource** - `GET /api/v1/events?namespace={ns}&resource={kind}&name={name}`
ArgoCD
- **List Applications** - `GET /api/v1/argocd/applications`
Claude MCP Endpoints
- **Analyze Resource** - `POST /api/v1/mcp/resource`
- **Troubleshoot Resource** - `POST /api/v1/mcp/troubleshoot`
- **Commit Analysis (GitLab)** - `POST /api/v1/mcp/commit`
- **Generic MCP Request** - `POST /api/v1/mcp`
All POST endpoints accept a JSON payload containing fields such as:
Postman Collection
A ready-to-use Postman collection will be available soon.
Donation
Please contribute to our coffee fund to help us continue to do great things [Buy Me Coffee](https://buymeacoffee.com/blankcut)
License
This project is licensed under the [MIT License](./LICENSE).
Contributing
Documentation will be expanded soon. If you d like to contribute, feel free to open a pull request or file an issue!