🚀 ⚡️ Serveur K6 Mcp

Qu'est-ce que le serveur k6 MCP ?

Le ### serveur k6 MCP est un outil puissant conçu pour les tests de performance et les tests de charge des applications. Il tire parti des capacités du cadre de test k6, qui est connu pour son efficacité et sa facilité d'utilisation. Le serveur MCP (Microservices Control Plane) permet aux utilisateurs de gérer et d'orchestrer plusieurs scripts de test k6, facilitant ainsi l'intégration dans les pipelines CI/CD et fournissant une plateforme centralisée pour surveiller et analyser les métriques de performance.

Fonctionnalités du serveur k6 MCP

• Gestion centralisée : Le serveur k6 MCP fournit une interface unique pour gérer plusieurs tests de performance, ce qui facilite l'organisation et l'exécution des tests dans différents environnements.
• Surveillance en temps réel : Les utilisateurs peuvent surveiller les résultats des tests en temps réel, permettant des aperçus immédiats sur la performance de l'application et une identification rapide des goulets d'étranglement.
• Intégration avec CI/CD : Le serveur peut être facilement intégré dans les workflows CI/CD existants, facilitant les tests de performance automatisés dans le cadre du processus de développement.
• Scalabilité : Conçu pour gérer un grand nombre d'utilisateurs simultanés, le serveur k6 MCP peut simuler des scénarios utilisateurs complexes pour tester la performance de l'application sous charge.
• Rapports détaillés : Le serveur génère des rapports complets qui fournissent des aperçus sur diverses métriques de performance, aidant les équipes à prendre des décisions éclairées basées sur les données.

Comment utiliser le serveur k6 MCP

1. Installation : Commencez par installer le serveur k6 MCP sur votre environnement préféré. Suivez la documentation officielle pour des instructions d'installation détaillées.
2. Configuration : Configurez les paramètres du serveur pour correspondre à vos exigences de test. Cela inclut la configuration des scripts de test, des scénarios utilisateurs et des seuils de performance.
3. Exécution des tests : Utilisez l'interface du serveur pour initier des tests de performance. Vous pouvez sélectionner des scripts de test spécifiques et définir le nombre d'utilisateurs virtuels à simuler.
4. Surveillance : Pendant que les tests sont en cours, surveillez les métriques de performance en temps réel via le tableau de bord du serveur.
5. Analyse des résultats : Après la fin des tests, examinez les rapports générés pour analyser les données de performance et identifier les problèmes à résoudre.

Questions Fréquemment Posées

Quel est le but principal du serveur k6 MCP ?

Le but principal du serveur k6 MCP est de faciliter les tests de performance et les tests de charge des applications, en fournissant une plateforme centralisée pour gérer plusieurs scripts de test et surveiller les résultats.

Puis-je intégrer le serveur k6 MCP dans mon pipeline CI/CD existant ?

Oui, le serveur k6 MCP est conçu pour s'intégrer parfaitement aux pipelines CI/CD, permettant des tests de performance automatisés dans le cadre du workflow de développement.

Comment le serveur k6 MCP gère-t-il les tests à grande échelle ?

Le serveur k6 MCP est construit pour évoluer, permettant aux utilisateurs de simuler un grand nombre d'utilisateurs simultanés et des scénarios utilisateurs complexes, ce qui le rend idéal pour tester des applications sous une forte charge.

Quel type de rapports le serveur k6 MCP génère-t-il ?

Le serveur k6 MCP génère des rapports de performance détaillés qui incluent des métriques telles que les temps de réponse, le débit, les taux d'erreur et l'utilisation des ressources, aidant les équipes à comprendre la performance de l'application de manière complète.

Existe-t-il une licence pour utiliser le serveur k6 MCP ?

Oui, le serveur k6 MCP est disponible sous la licence MIT, qui permet une utilisation, une modification et une distribution gratuites.

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