Xray MCP

A Model Context Protocol (MCP) server that integrates Cursor IDE with Xray Test Management for Jira, allowing you to manage tests, test executions, and test plans directly from your development environment.

Features

Tests

• List Tests: Fetch all tests from your Jira project with filtering options
• Get Test Details: Retrieve detailed test information including test steps via GraphQL ✨
• Get Test With Steps: NEW! Reliably fetch test details with steps using the GraphQL getTests query 🚀
• Create Test: Create new manual or automated tests
• Update Test: Modify existing tests

Test Executions

• List Test Executions: View all test executions in a project
• Get Test Execution Details: See detailed execution results including test runs
• Create Test Execution: Create new test execution sessions
• Update Test Run: Record test results (PASS, FAIL, TODO, EXECUTING, ABORTED)

Test Plans

• List Test Plans: View all test plans in a project
• Get Test Plan Details: See test plan information with associated tests
• Create Test Plan: Create new test plans
• Add Tests to Test Plan: Associate tests with existing plans

Test Sets

• List Test Sets: View all test sets in a project
• Get Test Set Details: See test set information with associated tests

Import Operations (CI/CD Integration) 🚀 NEW!

• Import Xray JSON Results: Import test execution results in Xray JSON format
• Import Cucumber Results: Import Cucumber JSON test results
• Import JUnit Results: Import JUnit XML test results
• Import TestNG Results: Import TestNG XML test results
• Import NUnit Results: Import NUnit XML test results
• Import Robot Framework Results: Import Robot Framework XML test results
• Import Behave Results: Import Behave JSON test results
• Import Feature Files: Import Cucumber .feature files (BDD scenarios)

Export Operations 📤 NEW!

• Export Cucumber Features: Export Cucumber feature files from Xray

Prerequisites

• Node.js 18 or higher
• npm or yarn
• Jira Cloud account with Xray Test Management plugin installed
• Jira API token for authentication

Installation

Option 1: Install from npm (Recommended)

The package is available on npm and can be used directly with npx:

npx @korfu/xray-mcp

No installation required! Continue to Generate Jira API Token section.

Option 2: Local Development Setup

If you want to contribute or modify the code:

1. Clone the Repository

git clone https://github.com/Korfu/mcp-xray.git
cd mcp-xray

2. Install Dependencies

npm install

3. Build the Project

npm run build

Setup

Generate Jira API Token

1. Go to Atlassian Account Settings
2. Click “Create API token”
3. Give it a descriptive name (e.g., “Xray MCP Integration”)