kubernetes-mcp-server
Claude Kubernetes MCP Server is a Go-based application for orchestrating Kubernetes environments. It integrates with ArgoCD, GitLab, Claude AI, and Kubernetes to automate deployments and interactions through a REST API.
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.
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)
Setup Instructions
- Clone the Repository
- Export Required Environment Variables
- Configure
config.yaml
Running Locally
Use Go commands to start the server with debug logging as needed.
Building and Running with Docker
- Build the Image
- Run the Container
Production Deployment
Deploy with Helm using the provided Helm chart.
API Documentation
Endpoints for health checks, Kubernetes namespace and resource listings, ArgoCD applications, and Claude MCP analysis.
Postman Collection
A Postman collection will be available soon.
License
This project is licensed under the .