Claude Kubernetes MCP Server

🚀 Kubernetes Claude MCP

This project provides a server for interacting with Kubernetes, Argo CD, GitLab, and Claude, offering various API endpoints for resource management and analysis.

🚀 Quick Start

Service Address

The configuration file kubernetes-claude-mcp/config.yaml contains the service configuration:

server:
  address: ":8080"
  readTimeout: 30
  writeTimeout: 60
  auth:
    apiKey: ""${API_KEY}"" 

kubernetes:
  kubeconfig: ""
  inCluster: false
  defaultContext: ""
  defaultNamespace: "default"

argocd:
  url: "http://example.argocd.com"
  authToken: ""
  username: "${ARGOCD_USERNAME}"
  password: "${ARGOCD_PASSWORD}"
  insecure: true

gitlab:
  url: "https://gitlab.com"
  authToken: "${AUTH_TOKEN}"
  apiVersion: "v4"
  projectPath: ""${PROJECT_PATH}""

claude:
  apiKey: "${API_KEY}"
  baseURL: "https://api.anthropic.com"
  modelID: "claude-3-haiku-20240307"
  maxTokens: 4096
  temperature: 0.7

Quick Run

To quickly run the service, use the following commands:

cd kubernetes-claude-mcp
go run ./cmd/server/main.go

Run with Debug Logs

LOG_LEVEL=debug go run ./cmd/server/main.go --config config.yaml

The service will start and bind to the address configured in config.yaml (default: 8080).

📦 Installation

Build and Run with Docker

1. Build the Image

cd kubernetes-claude-mcp
docker build -t claude-mcp-server -f Dockerfile .

2. Run the Container (Second Build Option)

cd kubernetes-claude-mcp
docker-compose build
docker-compose up -d

Production Deployment

The project includes a Helm chart for Kubernetes deployment:

1. Switch to the Helm Chart Directory

cd kubernetes-claude-mcp/deployments/helm

2. Deploy with Helm

Update the values in values.yaml and run:

helm install claude-mcp .

To upgrade:

helm upgrade claude-mcp .

Ensure that secrets and config maps are correctly mounted and securely configured in the cluster.

💻 Usage Examples

Basic Usage

The service provides various API endpoints for different operations. All requests require the X-API-Key header.

API Documentation

The following are the main endpoints exposed by the MCP server:

Basic

• Health Check
  • GET /api/v1/health

Kubernetes

• List Namespaces
  • GET /api/v1/namespaces
• List Resources
  • GET /api/v1/resources/{kind}?namespace={ns}
• Get a Specific Resource
  • GET /api/v1/resources/{kind}/{name}?namespace={ns}
• Get Resource Events
  • GET /api/v1/events?namespace={ns}&resource={kind}&name={name}

Argo CD

• List Applications
  • GET /api/v1/argocd/applications

Claude MCP Endpoints

• Analyze Resources
  • POST /api/v1/mcp/resource
• Troubleshoot Resources
  • POST /api/v1/mcp/troubleshoot
• Submit Analysis (GitLab)
  • POST /api/v1/mcp/commit
• Get Commit Status
  • GET /api/v1/mcp/commits/{cluster}

🤝 Contribution Guidelines

Submit Code

git clone https://github.com/yourusername/kubernetes-claude-mcp.git
cd kubernetes-claude-mcp
# Modify the code
git add .
git commit -m "Commit message"
git push origin main

Submit Issues

Please submit issues through Issues.

👥 Contributors

• [Your Name] - Project Maintainer
• Other Contributors - (Optional)

📄 License

LICENSE

Thank you for your support!