Reportportal MCP Server

🚀 ReportPortal MCP 服务器报告

ReportPortal MCP 服务器允许用户直接从 GitHub Copilot、Claude 等聊天工具中与 ReportPortal 交互，实现对测试执行结果的查询和分析，极大提升了测试结果处理的便捷性和效率。

🚀 快速开始

ReportPortal MCP 服务器可让用户直接在聊天工具里与 ReportPortal 交互，进行测试执行结果的查询与分析。使用前需完成安装和配置。

✨ 主要特性

ReportPortal MCP 服务器具备以下实用功能：

• 可分页列出启动，方便查看不同页面的启动信息。
• 能按名称获取启动详细信息，精准定位所需启动。
• 支持使用各种标准筛选启动，灵活筛选出符合条件的启动。
• 可查看测试执行报告，全面了解测试执行情况。

📦 安装指南

先决条件

• 需安装 Go 1.24.1 或更高版本。
• 要有 ReportPortal 实例。

从源代码构建

# 克隆仓库
git clone https://github.com/reportportal/reportportal-mcp-server.git
cd reportportal-mcp-server

# 构建二进制文件
go build -o reportportal-mcp-server ./cmd/reportportal-mcp-server

📚 详细文档

配置

服务器通过环境变量进行配置，具体如下：

使用方法

启动服务器

# 设置所需的环境变量
export RP_HOST="https://your-reportportal-instance.com"
export RP_PROJECT="your-project"
export RP_TOKEN="your-api-token"

# 运行服务器
./reportportal-mcp-server

可用工具

列出启动

列出 ReportPortal 启动，支持分页功能。 参数：

• page (可选): 页码（默认: 1）
• page-size (可选): 每页的项目数（默认: 20）

获取按名称最近的启动

检索指定名称的最新启动。 参数：

• launch: 要搜索的启动名称

按过滤器获取最近的启动

检索符合指定过滤条件的最新启动。 参数：

• name (可选): 按名称筛选
• description (可选): 按描述筛选
• uuid (可选): 按 UUID 筛选
• status (可选): 按启动状态筛选（IN_PROGRESS, PASSED, FAILED, STOPPED, SKIPPED, INTERRUPTED）
• start_time (可选): 按开始时间筛选（ unix 时间戳）
• end_time (可选): 按结束时间筛选（unix 时间戳）
• attributes (可选): 按属性筛选（逗号分隔的 key:value 对）
• mode (可选): 按启动模式筛选（DEFAULT 或 DEBUG）
• sort (可选): 排序方向和字段（默认: "desc(startTime)"）

列出特定启动的测试项

列出特定启动的测试项，支持分页功能。 参数:

• launch-id: 要获取测试项的启动 ID
• page (可选): 页码（默认: 1）
• page-size (可选): 每页的项目数（默认: 20）

获取特定测试项详细信息

检索特定测试项的详细信息。 参数:

• test_item_id: 要检索的测试项 ID