BlazeMeter MCP Server

Servidor MCP para pruebas de rendimiento de BlazeMeter impulsadas por IA

Documentación

BlazeMeter MCP Server

El servidor MCP de BlazeMeter conecta herramientas de IA directamente con la plataforma de pruebas de rendimiento basada en la nube de BlazeMeter. Esto brinda a los agentes de IA, asistentes y chatbots la capacidad de gestionar flujos de trabajo completos de pruebas de carga, desde la creación hasta la ejecución y los informes. Todo a través de interacciones en lenguaje natural.

[!NOTE]
Para documentación detallada, incluidos casos de uso, herramientas disponibles, puntos de integración y resolución de problemas, consulte la documentación del servidor MCP de BlazeMeter.

Requisitos previos

Credenciales de la API de BlazeMeter (ID de clave de API y secreto)
Cumplir con el consentimiento de IA de Blazemeter
Host MCP compatible (VS Code, Claude Desktop, Cursor, Windsurf, etc.)
Docker (solo para implementación basada en Docker)
uv y Python 3.11+ (solo para instalación desde la distribución del código fuente)

Configuración

Obtener credenciales de la API de BlazeMeter

Siga la guía de claves de API de BlazeMeter para obtener sus claves de API en formato JSON.

[!IMPORTANT]
Al descargar sus claves de API de BlazeMeter, guarde el archivo api-keys.json en la misma carpeta donde colocará el binario de MCP.

Configuración rápida con la herramienta CLI ⚡

La forma más sencilla de configurar su cliente MCP es mediante nuestra herramienta CLI interactiva:

Descargue el binario adecuado para su sistema operativo desde la página de Releases

[!NOTE]
Elija el binario que coincida con su sistema operativo (Windows, macOS, Linux)

Coloque el binario en la misma carpeta que su archivo api-keys.json

Ejecute o haga doble clic en el binario para iniciar la herramienta de configuración interactiva

La herramienta genera automáticamente el archivo de configuración JSON por usted

[!IMPORTANT]
Para macOS: es posible que vea una alerta de seguridad que indica "Apple no pudo verificar que 'bzm-mcp-darwin' esté libre de malware". Para resolverlo:

Vaya a Configuración del sistema → Privacidad y seguridad → Seguridad

Busque la aplicación bloqueada y haga clic en "Permitir de todos modos"

Intente ejecutar el binario nuevamente

CLI Demo

Configuración manual del cliente (instalación binaria)

Descargue el binario para su sistema operativo desde la página de Releases
Ejecute el binario una vez — imprimirá una configuración JSON y enlaces en los que se puede hacer clic para agregar este MCP en Cursor o VS Code.
O configure su cliente MCP manualmente con la siguiente configuración:

{
  "mcpServers": {
    "BlazeMeter MCP": {
      "command": "/path/to/bzm-mcp-binary",
      "args": ["--mcp"],
      "env": {
        "BLAZEMETER_API_KEY": "/path/to/your/api-key.json"
      }
    }
  }
}

Configuración manual del cliente (desde el código fuente remoto)

Requisitos previos: uv y Python 3.11+
Instalación con un clic o configure su cliente MCP manualmente:

Después de la instalación, establezca BLAZEMETER_API_KEY en la ruta de su api-key.json en la configuración de MCP de su cliente.

O configure manualmente con la siguiente configuración:

{
  "mcpServers": {
    "BlazeMeter MCP": {
      "command": "uvx",
      "args": [
        "--from", "git+https://github.com/Blazemeter/bzm-mcp.git@v1.0.1",
        "-q", "bzm-mcp", "--mcp"
      ],
      "env": {
        "BLAZEMETER_API_KEY": "/path/to/your/api-key.json"
      }
    }
  }
}

[!NOTE]
uvx instala y ejecuta el paquete y sus dependencias en un entorno temporal.
Puede cambiar a cualquier versión publicada o a cualquier rama que desee. El soporte de paquetes para el comando uvx está disponible desde la versión 1.0.1 en adelante.
Para obtener más detalles sobre los argumentos de uv/uvx utilizados, consulte la documentación oficial de uv.

Configuración del cliente MCP con Docker

Requisitos previos: Docker

Después de la instalación, establezca API_KEY_ID, API_KEY_SECRET y, opcionalmente, el directorio de montaje/trabajo en la configuración de MCP de su cliente.

{
  "mcpServers": {
    "Docker BlazeMeter MCP": {
      "command": "docker",
      "args": [
        "run",
        "--pull=always",
        "--rm",
        "-i",
        "--mount",
        "type=bind,source=/path/to/your/test/files,target=/home/bzm-mcp/working_directory/",
        "-e",
        "API_KEY_ID=your_api_key_id",
        "-e",
        "API_KEY_SECRET=your_api_key_secret",
        "-e",
        "SOURCE_WORKING_DIRECTORY=/path/to/your/test/files",
        "ghcr.io/blazemeter/bzm-mcp:latest"
      ]
    }
  }
}

[!IMPORTANT]
Para Windows, las rutas deben usar barras invertidas (\) y deben tener el escape correcto como dobles barras invertidas (\\) en la configuración JSON.
Por ejemplo: C:\\User\\Desktop\\mcp_test_folder

[!NOTE]
Para obtener el API_KEY_ID y el API_KEY_SECRET, consulte Claves de API de BlazeMeter

Certificados CA personalizados (entornos corporativos) para Docker

Cuándo lo necesita:

Su organización utiliza certificados autofirmados
Está detrás de un proxy corporativo con inspección SSL
Tiene una Autoridad de Certificación (CA) personalizada
Encuentra errores de verificación de certificados SSL al ejecutar pruebas

Configuración requerida:

Al usar paquetes de certificados CA personalizados, debe configurar ambos:

Montaje del volumen de certificados: monte su paquete de certificados CA personalizados en el contenedor
Variable de entorno SSL_CERT_FILE: establezca explícitamente la variable de entorno SSL_CERT_FILE para que apunte a la ubicación del certificado dentro del contenedor

Configuración de ejemplo

{
  "mcpServers": {
    "Docker BlazeMeter MCP": {
      "command": "docker",
      "args": [
        "run",
        "--pull=always",
        "--rm",
        "-i",
        "--mount",
        "type=bind,source=/path/to/your/test/files,target=/home/bzm-mcp/working_directory/",
        "-v",
        "/path/to/your/ca-bundle.crt:/etc/ssl/certs/custom-ca-bundle.crt",
        "-e",
        "SSL_CERT_FILE=/etc/ssl/certs/custom-ca-bundle.crt",
        "-e",
        "API_KEY_ID=your_api_key_id",
        "-e",
        "API_KEY_SECRET=your_api_key_secret",
        "-e",
        "SOURCE_WORKING_DIRECTORY=/path/to/your/test/files",
        "ghcr.io/blazemeter/bzm-mcp:latest"
      ]
    }
  }
}

Reemplace:

/path/to/your/ca-bundle.crt con la ruta del archivo de certificado CA de su sistema host
La ruta del contenedor /etc/ssl/certs/custom-ca-bundle.crt puede ser cualquier ruta que prefiera (solo asegúrese de que coincida con SSL_CERT_FILE)

La variable de entorno SSL_CERT_FILE debe establecerse para que apunte a su paquete de certificados CA personalizados. La biblioteca httpx respeta automáticamente la variable de entorno SSL_CERT_FILE para la verificación de certificados SSL.

OpenTelemetry

BlazeMeter MCP informa trazas y métricas de las llamadas a las herramientas de MCP mediante OpenTelemetry. Esto le brinda visibilidad sobre qué herramientas se usan, cuánto tardan y cuándo ocurren errores.

La telemetría está habilitada de forma predeterminada. No necesita configurar nada a menos que desee cambiar el destino de los datos o desactivarla.

Comportamiento predeterminado

De forma predeterminada, la telemetría se exporta a través de gRPC a:

https://grpc.public.prd.shared.perforce.com

El servicio se identifica como bzm-mcp con la versión de lanzamiento actual. Si la telemetría no se inicia o no se exporta, el servidor MCP continúa funcionando con normalidad.

Desactivar la telemetría

Agregue OTEL_SDK_DISABLED=true al entorno de su cliente MCP:

"env": {
  "OTEL_SDK_DISABLED": "true"
}

Para Docker, páselo con -e:

"-e",
"OTEL_SDK_DISABLED=true"

También puede pasar --no-telemetry en la línea de comandos (binario o instalación con uvx):

"args": ["--mcp", "--no-telemetry"]

Enviar datos a su propio recopilador

Use estas variables de entorno para apuntar a un recopilador de OpenTelemetry diferente (por ejemplo, uno local durante el desarrollo):

Variable	Descripción	Valor predeterminado
`OTEL_EXPORTER_OTLP_ENDPOINT`	URL del recopilador OTLP	`https://grpc.public.prd.shared.perforce.com`
`OTEL_EXPORTER_OTLP_PROTOCOL`	`grpc`, `http/protobuf` o `http/json`	`grpc`
`OTEL_EXPORTER_OTLP_HEADERS`	Encabezados `key=value` separados por comas para el recopilador	(ninguno)

Ejemplo con gRPC (recopilador local típico en el puerto 4317):

"env": {
  "OTEL_EXPORTER_OTLP_ENDPOINT": "http://localhost:4317",
  "OTEL_EXPORTER_OTLP_PROTOCOL": "grpc"
}

Ejemplo con HTTP (recopilador local típico en el puerto 4318):

"env": {
  "OTEL_EXPORTER_OTLP_ENDPOINT": "http://localhost:4318",
  "OTEL_EXPORTER_OTLP_PROTOCOL": "http/protobuf"
}

Al ejecutar el binario directamente, puede sobrescribir el punto de conexión y los encabezados con indicadores de CLI en lugar de variables de entorno:

"args": [
  "--mcp",
  "--otel-endpoint", "http://localhost:4317",
  "--otel-headers", "Authorization=Bearer token"
]

Qué se informa

Cada llamada a una herramienta de MCP crea:

Trazas: un tramo por llamada con el nombre de la herramienta, la acción, el nombre y la versión del cliente MCP, el ID de sesión y el tipo de error cuando corresponde.
Métricas: mcp.tool.calls (recuento) y mcp.tool.duration (segundos), desglosadas por herramienta y acción.

Los tokens de seguridad y otras credenciales no se incluyen en los datos de telemetría.

Si su cliente MCP envía traceparent o tracestate en los metadatos de la solicitud, BlazeMeter MCP vincula sus tramos a esa traza principal.

Licencia

Este proyecto está licenciado bajo la Licencia Apache, versión 2.0. Consulte LICENSE para conocer los términos completos.

Soporte

Documentación del servidor MCP: Guía del servidor MCP de BlazeMeter
Documentación de la API: Documentación de la API de BlazeMeter
Incidencias: Incidencias de GitHub
Soporte: comuníquese con el soporte de BlazeMeter para obtener asistencia empresarial