mcp-allure

# MCP-Allure 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": [ ] } ] } ] } ] } ```