JIRA Zephyr MCP Server

A Model Context Protocol (MCP) server that provides comprehensive integration with JIRA’s Zephyr test management system. This server enables seamless test management operations including creating test plans, managing test cycles, executing tests, and reading JIRA issues.

Features

Core Capabilities

• Test Plan Management: Create and list test plans in Zephyr
• Test Cycle Management: Create and manage test execution cycles
• JIRA Integration: Read JIRA issue details and metadata
• Test Execution: Update test execution results and status
• Progress Tracking: Monitor test execution progress and statistics
• Issue Linking: Associate test cases with JIRA issues
• Reporting: Generate comprehensive test execution reports

Available Tools

1. read_jira_issue - Retrieve JIRA issue information
2. create_test_plan - Create new test plans in Zephyr
3. list_test_plans - Browse existing test plans
4. create_test_cycle - Create test execution cycles
5. list_test_cycles - View test cycles with execution status
6. execute_test - Update test execution results
7. get_test_execution_status - Check test execution progress
8. link_tests_to_issues - Associate tests with JIRA issues
9. generate_test_report - Create test execution reports

Prerequisites

• Node.js 18.0.0 or higher
• JIRA instance with Zephyr Scale or Zephyr Squad
• Valid JIRA API credentials
• Zephyr API access token

Integration with Cursor

Clone the project, then add the following to your Cursor configuration:

{
  "mcpServers": {
    "jira-zephyr": {
      "command": "node",
      "args": ["/path/to/jira-zephyr-mcp/dist/index.js"],
      "env": {
        "JIRA_BASE_URL": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "your-jira-api-token",
        "ZEPHYR_API_TOKEN": "your-zephyr-api-token"
      }
    }
  }
}

Using Docker

Alternatively, you can configure Cursor to run the MCP server in Docker (ensure the image is built first):

{
  "mcpServers": {
    "jira-zephyr": {
      "command": "docker",
      "args": ["run", "--rm", "-i","-e","JIRA_BASE_URL","-e","JIRA_USERNAME","-e","JIRA_API_TOKEN","-e","ZEPHYR_API_TOKEN", "jira-zephyr-mcp"],
      "env": {
        "JIRA_BASE_URL": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "your-jira-api-token",
        "ZEPHYR_API_TOKEN": "your-zephyr-api-token"
      }
    }
  }
}

Installation (for development)

1. Clone the repository:

git clone https://github.com/your-username/jira-zephyr-mcp.git
cd jira-zephyr-mcp

2. Install dependencies:

npm install

3. Build the project:

npm run build

Configuration

1. Copy the example environment file:

cp .env.example .env

2. Configure your JIRA and Zephyr credentials in .env: