ReportPortal MCP 服务器

本仓库包含 ReportPortal 与 GitHub Copilot chat 的集成，通过 Microsoft Copilot for Pull Requests (MCP)。它允许用户直接从 GitHub Copilot chat 与 ReportPortal 交互，以查询和分析测试执行结果。

功能

ReportPortal MCP 服务器提供以下功能：

• 列出带有分页功能的 Launches
• 通过名称获取 Launch 详情
• 使用各种条件过滤 Launches
• 查看测试执行报告

安装

前提条件

• 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

可用工具

列出 Launches

列出带有分页支持的 ReportPortal Launches。

参数：

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

通过名称获取最近的 Launch

检索具有指定名称的最新 Launch。

参数：

• launch: 要搜索的 Launch 名称

通过过滤器获取最近的 Launch

检索与指定过滤器匹配的最新 Launch。

参数：

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

开发

运行测试

go test ./...

添加新工具

要添加新工具，请在相应的资源文件中创建一个新方法，并将其添加到 NewServer 函数中的服务器。

许可证

本项目基于 MIT 许可证。