🚀 ⚡️ Serveur Locust Mcp

Qu'est-ce que le serveur Locust MCP ?

Le ### serveur Locust MCP est une implémentation spécialisée conçue pour faciliter les tests de charge en utilisant Locust, un outil de test de charge open-source populaire. Ce serveur permet aux utilisateurs d'exécuter des tests de charge de manière efficace en intégrant les capacités de Locust avec des environnements de développement alimentés par l'IA. Il fournit un cadre robuste pour simuler le trafic utilisateur et mesurer les performances du système dans diverses conditions, ce qui en fait un outil essentiel pour les développeurs et les testeurs cherchant à s'assurer que leurs applications peuvent gérer les charges attendues.

Caractéristiques du serveur Locust MCP

• Intégration transparente : Le serveur Locust MCP s'intègre facilement aux environnements de développement existants, permettant une configuration et une exécution aisées des tests de charge.
• Capacités alimentées par l'IA : Exploitez les technologies de l'IA pour améliorer les stratégies de test de charge, fournissant des informations et des optimisations que les méthodes traditionnelles peuvent négliger.
• Scalabilité : Le serveur est conçu pour gérer un grand nombre d'utilisateurs simultanés, ce qui le rend adapté aux tests d'applications de toutes tailles.
• Surveillance en temps réel : Les utilisateurs peuvent surveiller les performances de leurs applications en temps réel pendant les tests de charge, permettant des retours et des ajustements immédiats.
• Scénarios personnalisables : Créez des scénarios de test de charge sur mesure qui imitent le comportement réel des utilisateurs, garantissant que les tests sont pertinents et efficaces.

Comment utiliser le serveur Locust MCP

1. Installation : Commencez par installer le serveur Locust MCP sur votre machine ou serveur. Suivez les instructions d'installation fournies dans la documentation.
2. Configuration : Configurez les paramètres du serveur pour correspondre à vos exigences de test. Cela inclut la configuration du nombre d'utilisateurs, de la durée du test et de tout scénario spécifique que vous souhaitez simuler.
3. Exécuter des tests : Démarrez les tests de charge via l'interface du serveur. Surveillez les progrès et les résultats en temps réel pour obtenir des informations sur les performances de votre application.
4. Analyser les résultats : Une fois les tests terminés, analysez les résultats pour identifier les goulets d'étranglement, les problèmes de performance et les domaines à améliorer.
5. Itérer : En fonction des résultats, apportez les ajustements nécessaires à votre application et répétez le processus de test pour garantir des performances optimales.

Questions Fréquemment Posées

Q : Quel est le but principal du serveur Locust MCP ?

R : Le but principal est de faciliter les tests de charge pour les applications, permettant aux développeurs de simuler le trafic utilisateur et d'évaluer les performances dans diverses conditions.

Q : Puis-je intégrer le serveur Locust MCP avec d'autres outils ?

R : Oui, le serveur Locust MCP est conçu pour s'intégrer à divers outils de développement et de test, améliorant ainsi sa fonctionnalité et son utilisation.

Q : Y a-t-il un coût associé à l'utilisation du serveur Locust MCP ?

R : Le serveur Locust MCP est open-source et gratuit à utiliser, ce qui le rend accessible aux développeurs et aux organisations de toutes tailles.

Q : Comment puis-je contribuer au projet du serveur Locust MCP ?

R : Les contributions sont les bienvenues ! Vous pouvez participer en signalant des problèmes, en suggérant des fonctionnalités ou en soumettant des améliorations de code via le dépôt du projet.

Q : Où puis-je trouver plus d'informations sur le serveur Locust MCP ?

R : Pour des informations plus détaillées, de la documentation et du support, visitez le site officiel à qainsights.com.

🚀 ⚡️ locust-mcp-server

A Model Context Protocol (MCP) server implementation for running Locust load tests. This server enables seamless integration of Locust load testing capabilities with AI-powered development environments.

✨ Features

• Simple integration with Model Context Protocol framework
• Support for headless and UI modes
• Configurable test parameters (users, spawn rate, runtime)
• Easy-to-use API for running Locust load tests
• Real-time test execution output
• HTTP/HTTPS protocol support out of the box
• Custom task scenarios support

🔧 Prerequisites

Before you begin, ensure you have the following installed:

• Python 3.13 or higher
• uv package manager (Installation guide)

📦 Installation

1. Clone the repository:

git clone https://github.com/qainsights/locust-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:

LOCUST_HOST=http://localhost:8089  # Default host for your tests
LOCUST_USERS=3                     # Default number of users
LOCUST_SPAWN_RATE=1               # Default user spawn rate
LOCUST_RUN_TIME=10s               # Default test duration

🚀 Getting Started

1. Create a Locust test script (e.g., hello.py):

from locust import HttpUser, task, between

class QuickstartUser(HttpUser):
    wait_time = between(1, 5)

    @task
    def hello_world(self):
        self.client.get("/hello")
        self.client.get("/world")

    @task(3)
    def view_items(self):
        for item_id in range(10):
            self.client.get(f"/item?id={item_id}", name="/item")
            time.sleep(1)

    def on_start(self):
        self.client.post("/login", json={"username":"foo", "password":"bar"})

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

{
  "mcpServers": {
    "locust": {
      "command": "/Users/naveenkumar/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/naveenkumar/Gits/locust-mcp-server",
        "run",
        "locust_server.py"
      ]
    }
  }
}

3. Now ask the LLM to run the test e.g. run locust test for hello.py. The Locust MCP server will use the following tool to start the test:

• run_locust: Run a test with configurable options for headless mode, host, runtime, users, and spawn rate

📝 API Reference

Run Locust Test

run_locust(
    test_file: str,
    headless: bool = True,
    host: str = "http://localhost:8089",
    runtime: str = "10s",
    users: int = 3,
    spawn_rate: int = 1
)

Parameters:

• test_file: Path to your Locust test script
• headless: Run in headless mode (True) or with UI (False)
• host: Target host to load test
• runtime: Test duration (e.g., "30s", "1m", "5m")
• users: Number of concurrent users to simulate
• spawn_rate: Rate at which users are spawned

✨ Use Cases

• LLM powered results analysis
• Effective debugging with the help of LLM

🤝 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.