JinDaGe - reportportal-mcp-server MCP Details

article

README

🚀 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

📚 详细文档

配置

服务器通过环境变量进行配置，具体如下： | 变量 | 描述 | 默认值 | |----------|------------------------|--------| | RP_HOST | ReportPortal 服务 URL | | | RP_PROJECT | ReportPortal 项目名称 | | | RP_TOKEN | ReportPortal API令牌 | | | MCP_PORT | 运行 MCP 服务器的端口 | 4389 |

使用方法

启动服务器

# 设置所需的环境变量
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

reportportal-mcp-server