🚀 ⚡️ Server K6 Mcp

Cos'è il k6 MCP Server?

Il ### k6 MCP Server è uno strumento potente progettato per il testing delle prestazioni e il load testing delle applicazioni. Sfrutta le capacità del framework di testing k6, noto per la sua efficienza e facilità d'uso. Il MCP (Microservices Control Plane) Server consente agli utenti di gestire e orchestrare più script di test k6, facilitando l'integrazione nei pipeline CI/CD e fornendo una piattaforma centralizzata per monitorare e analizzare le metriche delle prestazioni.

Caratteristiche del k6 MCP Server

• Gestione Centralizzata: Il k6 MCP Server fornisce un'interfaccia unica per gestire più test di prestazioni, rendendo più facile organizzare ed eseguire test in diversi ambienti.
• Monitoraggio in Tempo Reale: Gli utenti possono monitorare i risultati dei test in tempo reale, consentendo intuizioni immediate sulle prestazioni dell'applicazione e una rapida identificazione dei colli di bottiglia.
• Integrazione con CI/CD: Il server può essere facilmente integrato nei flussi di lavoro CI/CD esistenti, facilitando il testing delle prestazioni automatizzato come parte del processo di sviluppo.
• Scalabilità: Progettato per gestire un gran numero di utenti simultanei, il k6 MCP Server può simulare scenari utente complessi per testare le prestazioni dell'applicazione sotto carico.
• Reporting Dettagliato: Il server genera report completi che forniscono intuizioni su varie metriche delle prestazioni, aiutando i team a prendere decisioni informate basate sui dati.

Come Utilizzare il k6 MCP Server

1. Installazione: Inizia installando il k6 MCP Server nel tuo ambiente preferito. Segui la documentazione ufficiale per istruzioni dettagliate sull'installazione.
2. Configurazione: Configura le impostazioni del server per soddisfare i tuoi requisiti di testing. Questo include la configurazione degli script di test, degli scenari utente e delle soglie di prestazione.
3. Esecuzione dei Test: Utilizza l'interfaccia del server per avviare i test di prestazione. Puoi selezionare script di test specifici e definire il numero di utenti virtuali da simulare.
4. Monitoraggio: Mentre i test sono in esecuzione, monitora le metriche delle prestazioni in tempo reale attraverso il dashboard del server.
5. Analisi dei Risultati: Dopo il completamento dei test, rivedi i report generati per analizzare i dati sulle prestazioni e identificare eventuali problemi da affrontare.

Domande Frequenti

Qual è lo scopo principale del k6 MCP Server?

Lo scopo principale del k6 MCP Server è facilitare il testing delle prestazioni e il load testing delle applicazioni, fornendo una piattaforma centralizzata per gestire più script di test e monitorare i risultati.

Posso integrare il k6 MCP Server con il mio pipeline CI/CD esistente?

Sì, il k6 MCP Server è progettato per integrarsi senza problemi con i pipeline CI/CD, consentendo il testing delle prestazioni automatizzato come parte del flusso di lavoro di sviluppo.

Come gestisce il k6 MCP Server i test su larga scala?

Il k6 MCP Server è costruito per scalare, consentendo agli utenti di simulare un gran numero di utenti simultanei e scenari utente complessi, rendendolo ideale per testare applicazioni sotto carico pesante.

Che tipo di report genera il k6 MCP Server?

Il k6 MCP Server genera report dettagliati sulle prestazioni che includono metriche come tempi di risposta, throughput, tassi di errore e utilizzo delle risorse, aiutando i team a comprendere in modo completo le prestazioni dell'applicazione.

Esiste una licenza per utilizzare il k6 MCP Server?

Sì, il k6 MCP Server è disponibile sotto la licenza MIT, che consente l'uso, la modifica e la distribuzione gratuite.

🚀 ⚡️ 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.