🚀 ⚡️ Servidor Locust Mcp

¿Qué es el Servidor Locust MCP?

El ### Servidor Locust MCP es una implementación especializada diseñada para facilitar pruebas de carga utilizando Locust, una popular herramienta de pruebas de carga de código abierto. Este servidor permite a los usuarios realizar pruebas de carga de manera eficiente al integrar las capacidades de Locust con entornos de desarrollo impulsados por IA. Proporciona un marco robusto para simular el tráfico de usuarios y medir el rendimiento del sistema bajo diversas condiciones, convirtiéndose en una herramienta esencial para desarrolladores y testers que buscan asegurar que sus aplicaciones puedan manejar las cargas esperadas.

Características del Servidor Locust MCP

• Integración Sin Problemas: El Servidor Locust MCP se integra sin problemas con los entornos de desarrollo existentes, permitiendo una fácil configuración y ejecución de pruebas de carga.
• Capacidades Impulsadas por IA: Aprovecha las tecnologías de IA para mejorar las estrategias de pruebas de carga, proporcionando información y optimizaciones que los métodos tradicionales pueden pasar por alto.
• Escalabilidad: El servidor está diseñado para manejar un gran número de usuarios concurrentes, lo que lo hace adecuado para probar aplicaciones de todos los tamaños.
• Monitoreo en Tiempo Real: Los usuarios pueden monitorear el rendimiento de sus aplicaciones en tiempo real durante las pruebas de carga, lo que permite retroalimentación y ajustes inmediatos.
• Escenarios Personalizables: Crea escenarios de pruebas de carga a medida que imitan el comportamiento real de los usuarios, asegurando que las pruebas sean relevantes y efectivas.

Cómo Usar el Servidor Locust MCP

1. Instalación: Comienza instalando el Servidor Locust MCP en tu máquina o servidor. Sigue las instrucciones de instalación proporcionadas en la documentación.
2. Configuración: Configura los ajustes del servidor para que coincidan con tus requisitos de prueba. Esto incluye establecer el número de usuarios, la duración de la prueba y cualquier escenario específico que desees simular.
3. Ejecutar Pruebas: Inicia las pruebas de carga a través de la interfaz del servidor. Monitorea el progreso y los resultados en tiempo real para obtener información sobre el rendimiento de tu aplicación.
4. Analizar Resultados: Después de que las pruebas estén completas, analiza los resultados para identificar cuellos de botella, problemas de rendimiento y áreas de mejora.
5. Iterar: Basado en los hallazgos, realiza los ajustes necesarios en tu aplicación y repite el proceso de prueba para asegurar un rendimiento óptimo.

Preguntas Frecuentes

P: ¿Cuál es el propósito principal del Servidor Locust MCP?

R: El propósito principal es facilitar pruebas de carga para aplicaciones, permitiendo a los desarrolladores simular tráfico de usuarios y evaluar el rendimiento bajo diversas condiciones.

P: ¿Puedo integrar el Servidor Locust MCP con otras herramientas?

R: Sí, el Servidor Locust MCP está diseñado para integrarse con varias herramientas de desarrollo y pruebas, mejorando su funcionalidad y usabilidad.

P: ¿Hay algún costo asociado con el uso del Servidor Locust MCP?

R: El Servidor Locust MCP es de código abierto y gratuito, lo que lo hace accesible para desarrolladores y organizaciones de todos los tamaños.

P: ¿Cómo puedo contribuir al proyecto del Servidor Locust MCP?

R: ¡Las contribuciones son bienvenidas! Puedes participar reportando problemas, sugiriendo características o enviando mejoras de código a través del repositorio del proyecto.

P: ¿Dónde puedo encontrar más información sobre el Servidor Locust MCP?

R: Para obtener información más detallada, documentación y soporte, visita el sitio web oficial en 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.