MCP del núcleo de Kube

Un servicio de procesamiento de comandos de Kubernetes que convierte solicitudes de lenguaje natural en comandos kubectl válidos.

Características

• Conversión de lenguaje natural a comandos de kubectl

• Validación de comandos y comprobaciones de seguridad

• Compatibilidad con operaciones comunes de kubectl

• Integración de AWS Bedrock para el procesamiento de LLM

Related MCP server: MCP Remote Server for Kubernetes

Prerrequisitos

• Python 3.8+

• Credenciales de AWS configuradas

• kubectl instalado y configurado

• Node.js y npm (para frontend)

Configuración

1. Clonar el repositorio:

git clone <repository-url>
cd kube-core-mcp

2. Crear y activar un entorno virtual:

python3 -m venv venv
source venv/bin/activate  # On Windows: .\venv\Scripts\activate

3. Instalar dependencias:

pip install -r requirements.txt

4. Configurar las credenciales de AWS:

export AWS_ACCESS_KEY_ID=your_access_key
export AWS_SECRET_ACCESS_KEY=your_secret_key
export AWS_REGION=your_region

5. Inicie el servidor FastAPI:

python src/server.py

Documentación de la API

Chequeo de salud

curl http://localhost:3000/health

Servicios

curl http://localhost:3000/api/services

Comandos de lenguaje natural

curl -X POST http://localhost:3000/api/nl \
  -H "Content-Type: application/json" \
  -d '{"message": "show me the pods in default namespace"}'

Comandos directos

curl -X POST http://localhost:3000/api/command \
  -H "Content-Type: application/json" \
  -d '{"command": "kubectl get pods -n default"}'

Seguridad

El servicio funciona en dos modos de seguridad:

1. ESTRICTO (predeterminado):

   • Solo permite patrones de comando predefinidos

   • Valida todos los comandos contra patrones permitidos

   • Previene operaciones peligrosas

2. PERMISIVO:

   • Permite patrones de comando más flexibles

   • Aún mantiene controles de seguridad básicos.

   • Útil para desarrollo y pruebas.

Desarrollo

Ejecución de pruebas

pytest tests/

Estilo de código

black src/ tests/
flake8 src/ tests/

Contribuyendo

1. Bifurcar el repositorio

2. Crear una rama de características

3. Realiza tus cambios

4. Ejecutar pruebas

5. Enviar una solicitud de extracción

Licencia

[Agregar información de licencia]