MCP-Allure is a MCP server that reads Allure reports and returns them in LLM-friendly formats.

Motivation

As AI and Large Language Models (LLMs) become increasingly integral to software development, there is a growing need to bridge the gap between traditional test reporting and AI-assisted analysis. Traditional Allure test report formats, while human-readable, aren't optimized for LLM consumption and processing.

MCP-Allure addresses this challenge by transforming Allure test reports into LLM-friendly formats. This transformation enables AI models to better understand, analyze, and provide insights about test results, making it easier to:

• Generate meaningful test summaries and insights
• Identify patterns in test failures
• Suggest potential fixes for failing tests
• Enable more effective AI-assisted debugging
• Facilitate automated test documentation generation

By optimizing test reports for LLM consumption, MCP-Allure helps development teams leverage the full potential of AI tools in their testing workflow, leading to more efficient and intelligent test analysis and maintenance.

Problems Solved

• Efficiency: Traditional test reporting formats are not optimized for AI consumption, leading to inefficiencies in test analysis and maintenance.
• Accuracy: AI models may struggle with interpreting and analyzing test reports that are not in a format optimized for AI consumption.
• Cost: Converting test reports to LLM-friendly formats can be time-consuming and expensive.

Key Features

• Conversion: Converts Allure test reports into LLM-friendly formats.
• Optimization: Optimizes test reports for AI consumption.
• Efficiency: Converts test reports efficiently.
• Cost: Converts test reports at a low cost.
• Accuracy: Converts test reports with high accuracy.

Installation

To install mcp-repo2llm using uv:

{
  "mcpServers": {
    "mcp-allure-server": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/Users/crisschan/workspace/pyspace/mcp-allure/mcp-allure-server.py"
      ]
    }
  }
}

Tool

get_allure_report

• Reads Allure report and returns JSON data
• Input:
• report_dir: Allure HTML report path
• Return:
• String, formatted JSON data, like this:

  {
      "test-suites": [
          {
              "name": "test suite name",
              "title": "suite title",
              "description": "suite description",
              "status": "passed",
              "start": "timestamp",
              "stop": "timestamp",
              "test-cases": [
                  {
                      "name": "test case name",
                      "title": "case title",
                      "description": "case description",
                      "severity": "normal",
                      "status": "passed",
                      "start": "timestamp",
                      "stop": "timestamp",
                      "labels": [
  
                      ],
                      "parameters": [
  
                      ],
                      "steps": [
                          {
                              "name": "step name",
                              "title": "step title",
                              "status": "passed",
                              "start": "timestamp",
                              "stop": "timestamp",
                              "attachments": [
  
                              ],
                              "steps": [
  
                              ]
                          }
                      ]
                  }
              ]
          }
      ]
  }