🚀 ⚡️ Servidor K6 Mcp

¿Qué es el servidor k6 MCP?

El ### servidor k6 MCP es una herramienta poderosa diseñada para pruebas de rendimiento y pruebas de carga de aplicaciones. Aprovecha las capacidades del marco de pruebas k6, que es conocido por su eficiencia y facilidad de uso. El servidor MCP (Microservices Control Plane) permite a los usuarios gestionar y orquestar múltiples scripts de prueba k6, facilitando la integración sin problemas en las tuberías CI/CD y proporcionando una plataforma centralizada para monitorear y analizar métricas de rendimiento.

Características del servidor k6 MCP

• Gestión Centralizada: El servidor k6 MCP proporciona una única interfaz para gestionar múltiples pruebas de rendimiento, lo que facilita la organización y ejecución de pruebas en diferentes entornos.
• Monitoreo en Tiempo Real: Los usuarios pueden monitorear los resultados de las pruebas en tiempo real, lo que permite obtener información inmediata sobre el rendimiento de la aplicación y la identificación rápida de cuellos de botella.
• Integración con CI/CD: El servidor se puede integrar fácilmente en flujos de trabajo CI/CD existentes, facilitando pruebas de rendimiento automatizadas como parte del proceso de desarrollo.
• Escalabilidad: Diseñado para manejar un gran número de usuarios concurrentes, el servidor k6 MCP puede simular escenarios de usuario complejos para probar el rendimiento de la aplicación bajo carga.
• Informes Detallados: El servidor genera informes completos que proporcionan información sobre varias métricas de rendimiento, ayudando a los equipos a tomar decisiones informadas basadas en datos.

Cómo usar el servidor k6 MCP

1. Instalación: Comienza instalando el servidor k6 MCP en tu entorno preferido. Sigue la documentación oficial para obtener instrucciones de instalación detalladas.
2. Configuración: Configura los ajustes del servidor para que coincidan con tus requisitos de prueba. Esto incluye configurar scripts de prueba, escenarios de usuario y umbrales de rendimiento.
3. Ejecución de Pruebas: Utiliza la interfaz del servidor para iniciar pruebas de rendimiento. Puedes seleccionar scripts de prueba específicos y definir el número de usuarios virtuales a simular.
4. Monitoreo: Mientras se ejecutan las pruebas, monitorea las métricas de rendimiento en tiempo real a través del panel del servidor.
5. Análisis de Resultados: Después de que se completan las pruebas, revisa los informes generados para analizar los datos de rendimiento e identificar cualquier problema que necesite atención.

Preguntas Frecuentes

¿Cuál es el propósito principal del servidor k6 MCP?

El propósito principal del servidor k6 MCP es facilitar las pruebas de rendimiento y las pruebas de carga de aplicaciones, proporcionando una plataforma centralizada para gestionar múltiples scripts de prueba y monitorear resultados.

¿Puedo integrar el servidor k6 MCP con mi tubería CI/CD existente?

Sí, el servidor k6 MCP está diseñado para integrarse sin problemas con las tuberías CI/CD, permitiendo pruebas de rendimiento automatizadas como parte del flujo de trabajo de desarrollo.

¿Cómo maneja el servidor k6 MCP pruebas a gran escala?

El servidor k6 MCP está construido para escalar, permitiendo a los usuarios simular un gran número de usuarios concurrentes y escenarios de usuario complejos, lo que lo hace ideal para probar aplicaciones bajo carga pesada.

¿Qué tipo de informes genera el servidor k6 MCP?

El servidor k6 MCP genera informes de rendimiento detallados que incluyen métricas como tiempos de respuesta, rendimiento, tasas de error y utilización de recursos, ayudando a los equipos a comprender el rendimiento de la aplicación de manera integral.

¿Hay una licencia para usar el servidor k6 MCP?

Sí, el servidor k6 MCP está disponible bajo la licencia MIT, que permite su uso, modificación y distribución de forma gratuita.

🚀 ⚡️ k6-mcp-server

A Model Context Protocol (MCP) server implementation for running k6 load tests.

✨ Features

• Simple integration with Model Context Protocol framework
• Support for custom test durations and virtual users (VUs)
• Easy-to-use API for running k6 load tests
• Configurable through environment variables
• Real-time test execution output

🔧 Prerequisites

Before you begin, ensure you have the following installed:

• Python 3.12 or higher
• k6 load testing tool (Installation guide)
• uv package manager (Installation guide)

📦 Installation

1. Clone the repository:

git clone https://github.com/qainsights/k6-mcp-server.git

2. Install the required dependencies:

uv pip install -r requirements.txt

3. Set up environment variables (optional): Create a .env file in the project root:

K6_BIN=/path/to/k6  # Optional: defaults to 'k6' in system PATH

🚀 Getting Started

1. Create a k6 test script (e.g., test.js):

import http from "k6/http";
import { sleep } from "k6";

export default function () {
  http.get("http://test.k6.io");
  sleep(1);
}

2. Configure the MCP server using the below specs in your favorite MCP client (Claude Desktop, Cursor, Windsurf and more):

{
  "mcpServers": {
    "k6": {
      "command": "/path/to/bin/uv",
      "args": [
        "--directory",
        "/path/to/k6-mcp-server",
        "run",
        "k6_server.py"
      ]
    }
  }
}

3. Now ask the LLM to run the test e.g. run k6 test for hello.js. The k6 mcp server will leverage either one of the below tools to start the test.

• execute_k6_test: Run a test with default options (30s duration, 10 VUs)
• execute_k6_test_with_options: Run a test with custom duration and VUs

📝 API Reference

Execute K6 Test

execute_k6_test(
    script_file: str,
    duration: str = "30s",  # Optional
    vus: int = 10          # Optional
)

Execute K6 Test with Custom Options

execute_k6_test_with_options(
    script_file: str,
    duration: str,
    vus: int
)

✨ Use cases

• LLM powered results analysis
• Effective debugging of load tests

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.