MCP-Allure

MCP-Allure 是一个 MCP 服务器，用于读取 Allure 报告并将其转换为适合大型语言模型（LLM）的格式。

动机

随着人工智能（AI）和大型语言模型（LLM）在软件开发中变得越来越重要，迫切需要弥合传统测试报告与 AI 辅助分析之间的差距。传统的 Allure 测试报告格式虽然对人类可读，但并未针对 LLM 的消费和处理进行优化。

MCP-Allure 通过将 Allure 测试报告转换为适合 LLM 的格式来解决这一挑战。这种转换使 AI 模型能够更好地理解、分析并提供关于测试结果的见解，从而更容易：

• 生成有意义的测试摘要和见解
• 识别测试失败的规律
• 为失败的测试建议潜在的修复方案
• 实现更有效的 AI 辅助调试
• 促进自动化测试文档的生成

通过优化测试报告以适应 LLM 的消费，MCP-Allure 帮助开发团队在测试工作流程中充分利用 AI 工具的潜力，从而实现更高效和智能的测试分析和维护。

解决的问题

• 效率：传统的测试报告格式未针对 AI 消费进行优化，导致测试分析和维护效率低下。
• 准确性：AI 模型可能难以解释和分析未针对 AI 消费优化的测试报告。
• 成本：将测试报告转换为适合 LLM 的格式可能耗时且昂贵。

主要功能

• 转换：将 Allure 测试报告转换为适合 LLM 的格式。
• 优化：优化测试报告以适应 AI 消费。
• 效率：高效地转换测试报告。
• 成本：以低成本转换测试报告。
• 准确性：高精度地转换测试报告。

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 MCP-Allure：

npx -y @smithery/cli install @crisschan/mcp-allure --client claude

手动安装

要使用 uv 安装 mcp-repo2llm：

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

工具

get_allure_report

• 读取 Allure 报告并返回 JSON 数据
• 输入：
  • report_dir: Allure HTML 报告路径
• 返回：
  • 字符串，格式化的 JSON 数据，如下所示：

{
    "test-suites": [
        {
            "name": "测试套件名称",
            "title": "套件标题",
            "description": "套件描述",
            "status": "通过",
            "start": "时间戳",
            "stop": "时间戳",
            "test-cases": [
                {
                    "name": "测试用例名称",
                    "title": "用例标题",
                    "description": "用例描述",
                    "severity": "普通",
                    "status": "通过",
                    "start": "时间戳",
                    "stop": "时间戳",
                    "labels": [

                    ],
                    "parameters": [

                    ],
                    "steps": [
                        {
                            "name": "步骤名称",
                            "title": "步骤标题",
                            "status": "通过",
                            "start": "时间戳",
                            "stop": "时间戳",
                            "attachments": [

                            ],
                            "steps": [

                            ]
                        }
                    ]
                }
            ]
        }
    ]
}