korfu/mcp-xray

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

2 stars 5 forks 质量 75 趋势 12MIT

Repository Install

MCP to work with Jira integration of Xray

概览

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. - : Fetch all tests from your Jira project with filtering options - : Retrieve detailed test information ✨ - : Reliably fetch test details with steps using the GraphQL getTests query 🚀 - : Create new manual or automated tests - : Modify existing tests - : View all test executions in a project - : See detailed execution results including test runs - : Create new test execution sessions - : Record test results (PASS, FAIL, TODO, EXECUTING, ABORTED) - : View all test plans in a project - : See test plan information with associated tests - : Create new test plans - : Associate tests with existing plans - : View all test sets in a project - : See test set information with associated tests - : Import test execution results in Xray JSON format - : Import Cucumber JSON test results -...

README

以下为原文 README 节选，完整内容请查看原文。

Xray MCP

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

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

在 GitHub 查看完整 README

安装

npx -y @korfu/xray-mcp

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "xray": {
      "command": "npx",
      "args": ["-y", "@korfu/xray-mcp"],
      "env": {
        "JIRA_BASE_URL": "https://your-domain.atlassian.net",
        "JIRA_EMAIL": "[email protected]",
        "JIRA_API_TOKEN": "your-api-token-here",
        "XRAY_CLIENT_ID": "your-xray-client-id",
        "XRAY_CLIENT_SECRET": "your-xray-client-secret"
      }
    }
  }
}