Reportportal MCP Server

🚀 ReportPortal MCP Server Report

This repository contains a ReportPortal MCP Server. It allows users to interact with ReportPortal directly from chats like GitHub Copilot / Claude / etc. to query and analyze test execution results.

🚀 Quick Start

The ReportPortal MCP Server enables users to interact with ReportPortal directly from chat interfaces such as GitHub Copilot or Claude. This facilitates seamless querying and analysis of test execution results, enhancing the efficiency of the testing process.

✨ Features

The ReportPortal MCP Server offers the following features:

• List launches with pagination.
• Get launch details by name.
• Filter launches using various criteria.
• View test execution reports.

📦 Installation

Prerequisites

• Go 1.24.1 or higher.
• A ReportPortal instance.

Build from Source

# Clone the repository
git clone https://github.com/reportportal/reportportal-mcp-server.git
cd reportportal-mcp-server

# Build the binary
go build -o reportportal-mcp-server ./cmd/reportportal-mcp-server

📚 Documentation

Configuration

The server is configured using environment variables:

Usage

Start the Server

# Set the required environment variables
export RP_HOST="https://your-reportportal-instance.com"
export RP_PROJECT="your-project"
export RP_TOKEN="your-api-token"

# Run the server
./reportportal-mcp-server

Available Tools

List Launches

List ReportPortal launches with pagination support. Parameters:

• page (optional): Page number (default: 1).
• page-size (optional): Number of items per page (default: 20).

Get the Latest Launch by Name

Retrieve the latest launch with the specified name. Parameters:

• launch: Name of the launch to search for.

Get the Latest Launch by Filter

Retrieve the latest launch that meets the specified filter criteria. Parameters:

• name (optional): Filter by name.
• description (optional): Filter by description.
• uuid (optional): Filter by UUID.
• status (optional): Filter by launch status (IN_PROGRESS, PASSED, FAILED, STOPPED, SKIPPED, INTERRUPTED).
• start_time (optional): Filter by start time (Unix timestamp).
• end_time (optional): Filter by end time (Unix timestamp).
• attributes (optional): Filter by attributes (comma-separated key:value pairs).
• mode (optional): Filter by launch mode (DEFAULT or DEBUG).
• sort (optional): Sort direction and field (default: "desc(startTime)").

List Test Items of a Specific Launch

List test items of a specific launch with pagination support. Parameters:

• launch-id: ID of the launch to get test items from.
• page (optional): Page number (default: 1).
• page-size (optional): Number of items per page (default: 20).

Get Details of a Specific Test Item

Retrieve detailed information of a specific test item. Parameters:

• test_item_id: ID of the test item to retrieve.