MCP Kubernetes

Execute comandos do Kubernetes usando kubectl a partir de qualquer cliente compatível com MCP. Requer um arquivo kubeconfig válido.

Documentação

MCP Kubernetes

Um servidor Model Context Protocol (MCP) para executar comandos Kubernetes a partir do Claude Desktop ou de qualquer cliente compatível com MCP.

Instalação

Você pode instalar esta ferramenta diretamente usando Go:

go install github.com/BhagyaAmarasinghe/mcp-kubernetes@latest

Uso

Iniciando o servidor

Execute o servidor MCP Kubernetes:

mcp-kubernetes

Por padrão, o servidor executa usando transporte stdio. Você pode especificar uma porta diferente para transporte HTTP com a flag -port:

mcp-kubernetes -port 8080

Usando com o Claude Desktop

  1. Configure o Claude Desktop para usar o servidor MCP Kubernetes adicionando-o ao seu claude_desktop_config.json:
{
  "mcpServers": {
    "kubernetes": {
      "command": "mcp-kubernetes"
    }
  }
}
  1. Agora você pode usar o Claude para executar comandos Kubernetes, como:
    • "Mostre-me os pods no namespace padrão"
    • "Liste todos os serviços em todos os namespaces"
    • "Verifique o status do meu deployment chamado my-app"

Comandos Disponíveis

O servidor MCP Kubernetes suporta as seguintes solicitações MCP:

execute

Executa um comando kubectl:

{
  "command": "get pods -n default"
}

get-contexts

Recupera uma lista de contextos Kubernetes disponíveis:

{}

current-context

Obtém o contexto Kubernetes atual:

{}

set-context

Define o contexto Kubernetes atual:

{
  "context": "minikube"
}

Segurança

Este servidor MCP executa comandos kubectl diretamente na sua máquina, portanto, deve ser usado apenas em ambientes confiáveis. Ele não implementa controles de autenticação ou autorização por padrão.

Requisitos

  • Go 1.23 ou superior
  • kubectl instalado e no seu PATH
  • Um arquivo kubeconfig válido

Licença

MIT