ReportPortal MCP 服务器报告

此仓库包含一个ReportPortal MCP Server。它允许用户直接从GitHub Copilot / Claude / 等聊天中与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