kubectl MCP (Model Context Protocol) Plugin

Overview

El plugin kubectl-mcp implementa un servidor Model Context Protocol (MCP) per a kubectl. Aquest servidor permet als assistents IA com Amazon Q interactuar directament amb la funcionalitat de kubectl a través d’un protocol estandarditzat, facilitant la integració sense costura de les comandes de kubectl en fluxos de treball impulsats per IA.

What is MCP?

Model Context Protocol (MCP) és un protocol obert que estandarditza com les aplicacions proporcionen context i eines als models de llenguatge grans (LLMs). Permet als assistents IA:

1. Descobrir les eines disponibles i les seves capacitats
2. Executar comandes i rebre respostes estructurades
3. Proporcionar informació contextual per millorar les interaccions amb l’IA

How the kubectl MCP Plugin Works

El plugin kubectl MCP expone totes les comandes de kubectl com a eines que poden ser invocades pels assistents IA. La implementació es compon de diversos components clau:

Core Components

1. main.go: Punt d’entrada que inicia el servidor MCP
2. pkg/mcp/server.go: Crea i configura el servidor MCP amb totes les comandes de kubectl
3. pkg/mcp/tools.go: Gestiona el registre de les comandes de kubectl com a eines MCP

Implementation Details

• El servidor utilitza la biblioteca mcp-go per implementar el Model Context Protocol
• Registra dinàmicament totes les comandes de kubectl (get, apply, delete, etc.) com a eines MCP
• Exposa el text d’ajuda, les banderes i els paràmetres de cada comanda a través del protocol
• El servidor funciona com un servidor stdio, comunicant-se a través d’entrada/sortida estàndard

Command Registration Process

1. El servidor recorre recursivament l’arbre de comandes de kubectl
2. Per a cada comanda, extreu:
   • Descripció i informació d’ús de la comanda
   • Banderes disponibles i les seves descripcions
   • Paràmetres obligatoris i opcionals

Using the kubectl MCP Plugin with Amazon Q Chat

Per utilitzar el plugin kubectl MCP amb Amazon Q Chat, cal registrar-lo en el fitxer de configuració d’Amazon Q.

Crear o editar el fitxer a $HOME/.aws/amazonq/mcp.json amb el contingut següent:

Aquesta configuració indica a Amazon Q Chat que:

1. Registre un servidor anomenat "kubectl"
2. Utilitzi la comanda kubectl-mcp per iniciar el servidor MCP
3. Fes totes les comandes de kubectl disponibles com a eines amb el prefix kubectl___

Benefits

• Seamless Integration: Els assistents IA poden executar comandes de kubectl directament
• Structured Responses: Les comandes retornen dades estructurades que poden ser analitzades pels models IA
• Discoverability: Els assistents IA poden descobrir les comandes disponibles i els seus paràmetres
• Context-Aware: Proporciona un context ric sobre els recursos de Kubernetes

Installation

Per instal·lar el plugin kubectl MCP:

1. Construeix el plugin: make kubectl-mcp
2. Mou el binari a una ubicació dins del teu PATH: sudo mv kubectl-mcp /usr/local/bin/
3. Verifica la instal·lació: kubectl plugin list | grep mcp

Quick test for MCP server

Per provar ràpidament el servidor MCP, executa la següent comanda al teu terminal:

Recommendations

• Monitoritza les operacions en segon pla per a comandes de llarg termini. Les comandes com la creació de recursos tenen un temps d’espera de 45 segons per a les respostes, però els processos continuen en segon pla.
• Per a operacions complexes de kubectl, considera utilitzar el plugin en combinació amb kubectl apply -f per a la gestió declarativa de recursos.