🚀 MCP-Allure

MCP-Allure 是一款 MCP 服务器，它能够读取 Allure 报告，并以对大语言模型（LLM）友好的格式返回结果，助力开发团队更好地利用 AI 进行测试分析。

🚀 快速开始

MCP-Allure 旨在解决传统测试报告与 AI 分析之间的衔接问题，通过将 Allure 测试报告转换为 LLM 友好格式，让 AI 模型能更高效地理解和分析测试结果，为测试工作带来更多便利和价值。

✨ 主要特性

• 转换：可将 Allure 测试报告转换为 LLM 友好格式。
• 优化：对测试报告进行优化，以便 AI 更好地消费。
• 高效：能高效地完成测试报告的转换工作。
• 低成本：以较低的成本实现测试报告的转换。
• 高准确性：高精度地转换测试报告，确保信息准确。

📦 安装指南

使用 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": [

                            ]
                        }
                    ]
                }
            ]
        }
    ]
}

📚 详细文档

解决的问题

• 效率：传统测试报告格式不适合 AI 消费，导致测试分析和维护效率低下。
• 准确性：AI 模型可能难以解读和分析不适合 LLM 消费的测试报告。
• 成本：将测试报告转换为 LLM 友好格式可能会耗费大量时间和资源。