allure-testops-mcp

Servidor MCP para Allure TestOps. Permite que un agente LLM (Claude Code, Cursor, OpenCode, etc.) consulte proyectos, ejecuciones, casos de prueba y resultados de pruebas a través de la API REST de Allure.

Python, FastMCP, transporte stdio.

Funciona con cualquier instancia de Allure TestOps, ya sea SaaS qameta.io o autohospedada / on-prem. Diseñado pensando en redes corporativas: omisión de proxy configurable, alternancia opcional de verificación SSL y autenticación mediante token de API.

Aspectos destacados del diseño

• Anotaciones de herramientas — cada herramienta está marcada como readOnlyHint: True / openWorldHint: True. Las 6 herramientas son de solo lectura; los clientes MCP no solicitarán confirmación.

• Salida estructurada en cada herramienta — cada herramienta declara un tipo de retorno TypedDict, por lo que FastMCP genera automáticamente un outputSchema y cada resultado contiene tanto structuredContent (carga útil tipada) como un bloque de texto markdown pre-renderizado.

• Errores estructurados — los errores de autenticación, 404, 403, 429, 5xx y variables de entorno faltantes se convierten en mensajes procesables (p. ej., "Authentication failed — verify ALLURE_TOKEN has API scope").

• Validación de entrada Pydantic — cada argumento tiene restricciones tipadas (rangos, longitudes, literales) expuestas automáticamente como JSON Schema.

• Paginación — las herramientas de listado devuelven un bloque pagination con page, total, has_more, next_page.

• Informes de progreso a través de MCP Context — las herramientas que realizan múltiples llamadas a la API (allure_get_project_statistics, allure_search_failed_tests) y allure_list_test_cases emiten eventos ctx.report_progress + ctx.info para que los clientes compatibles puedan renderizar barras de progreso y etiquetas de paso.

Related MCP server: Allure TestOps MCP

Características

6 herramientas que cubren los flujos de trabajo diarios de Allure TestOps:

Descubrimiento

• allure_list_projects — todos los proyectos con ID, nombre y abreviatura

• allure_get_project_statistics — recuento de TC, tasa de automatización, resumen de la última ejecución

Ejecuciones y resultados

• allure_list_launches — ejecuciones recientes con estadísticas de éxito/fallo

• allure_get_test_results — resultados de pruebas en una ejecución (filtrar por estado)

• allure_search_failed_tests — pruebas FAILED/BROKEN en la última ejecución o en una especificada

Casos de prueba

• allure_list_test_cases — casos de prueba con filtro automatizado/manual (cada resultado también lleva su capa, p. ej., UNIT / API / E2E)

Instalación

Requiere Python 3.10+.

# via uvx (recommended)
uvx --from allure-testops-mcp allure-testops-mcp

# or via pipx
pipx install allure-testops-mcp

Configuración

Versión corta — claude mcp add:

claude mcp add allure -s project \
  --env ALLURE_URL=https://allure.example.com \
  --env ALLURE_TOKEN=your-api-token \
  --env ALLURE_SSL_VERIFY=true \
  -- uvx --from allure-testops-mcp allure-testops-mcp

O en ~/.claude.json / .mcp.json del proyecto:

{
  "mcpServers": {
    "allure": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "allure-testops-mcp", "allure-testops-mcp"],
      "env": {
        "ALLURE_URL": "https://allure.example.com",
        "ALLURE_TOKEN": "${ALLURE_TOKEN}",
        "ALLURE_SSL_VERIFY": "true"
      }
    }
  }
}

Consulte .env.example para ver una plantilla de todas las variables de entorno admitidas.

Comprobación:

claude mcp list
# allure: uvx --from allure-testops-mcp allure-testops-mcp - ✓ Connected

Variables de entorno

Ejemplo de uso

En Claude Code:

• "List all Allure projects"

• "Show last 10 launches for project 63"

• "Failed tests in the last launch for project 175"

• "Automation rate for project 842"

• "Test results in launch 12345 with status FAILED"

Consideraciones de seguridad

• El token de API se lee de la variable de entorno ALLURE_TOKEN — nunca se pasa por la línea de comandos y nunca se escribe en los registros.

• Los secretos no se repiten en las respuestas de las herramientas (sin volcados de stat.request_headers, sin reflexión de session.auth).

• SSL autofirmado es opcional mediante ALLURE_SSL_VERIFY=false — el valor predeterminado es true. Deshabilitar la verificación en una red pública es un riesgo de seguridad; utilícelo solo para instancias corporativas de confianza.

• La detección de proxy está deshabilitada (session.trust_env = False) — el MCP ignora deliberadamente las variables de entorno HTTP_PROXY/HTTPS_PROXY para que la sesión no pueda ser enrutada silenciosamente a través de un proxy no deseado. Si su instancia de Allure solo es accesible a través de un proxy, ejecute el MCP en un entorno donde requests pueda resolver directamente.

• No se exponen operaciones de escritura — las 6 herramientas son de solo lectura. Incluso si el token de API tiene alcance de escritura, este servidor MCP no puede crear, modificar ni eliminar nada en Allure TestOps.

• Validación de entrada mediante Pydantic — cada argumento de herramienta está tipado y acotado (los ID deben ser ≥ 1, la paginación limitada a 200-500).

Límites de tasa

Allure TestOps aplica límites de tasa por instancia (típicamente ~60 solicitudes / minuto para tokens de API). En caso de HTTP 429, el MCP devuelve un error procesable sugiriendo que:

• Espere 30-60 segundos antes de volver a intentarlo.

• Reduzca el parámetro size (predeterminado 50 para resultados de pruebas, 200 para proyectos).

• Pagine con tamaños de página más pequeños.

Dos herramientas realizan múltiples llamadas a la API internamente:

• allure_get_project_statistics — 3 llamadas (recuentos de TC + ejecuciones + estadísticas de ejecución).

• allure_search_failed_tests — 2-3 llamadas (resolución de la última ejecución + FAILED + BROKEN).

Ambas utilizan el Context de MCP para informar el progreso paso a paso; allure_list_test_cases también emite un único evento de progreso. Supervise el flujo de progreso en clientes compatibles.

Desarrollo

git clone https://github.com/mshegolev/allure-testops-mcp.git
cd allure-testops-mcp
pip install -e '.[dev]'
pytest

Ejecute el servidor directamente (transporte stdio, espera en stdin los mensajes MCP):

ALLURE_URL=... ALLURE_TOKEN=... allure-testops-mcp

Licencia

MIT © Mikhail Shchegolev