Package Exports

zephyr-scale-mcp-server
zephyr-scale-mcp-server/build/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (zephyr-scale-mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Zephyr Scale MCP Server

Model Context Protocol server for Zephyr Scale test management. Create, read, and manage test cases through the Atlassian REST API.

Quick Start

Option 1: Install from npm

npm install -g zephyr-scale-mcp-server

Option 2: Build locally

# Clone and build
git clone <repository-url>
cd zephyr-scale-mcp-server
npm install
npm run build

# Configure environment
export ZEPHYR_API_KEY="your-api-token"
export ZEPHYR_BASE_URL="https://your-company.atlassian.net"

# Test the server
node build/index.js

MCP Configuration

For npm installation:

{
  "mcpServers": {
    "zephyr-server": {
      "command": "zephyr-scale-mcp",
      "env": {
        "ZEPHYR_API_KEY": "your-api-token",
        "ZEPHYR_BASE_URL": "https://your-company.atlassian.net"
      }
    }
  }
}

For local build:

{
  "mcpServers": {
    "zephyr-server": {
      "command": "node",
      "args": ["/path/to/zephyr-scale-mcp-server/build/index.js"],
      "env": {
        "ZEPHYR_API_KEY": "your-api-token",
        "ZEPHYR_BASE_URL": "https://your-company.atlassian.net"
      }
    }
  }
}

Available Tools

create_test_case - Create STEP_BY_STEP or PLAIN_TEXT test cases
create_test_case_with_bdd - Create BDD/Gherkin test cases
get_test_case - Get test case details
update_test_case_bdd - Update BDD test cases
create_folder - Create test case folders
get_test_run_cases - Get test cases from test runs

Examples

Simple Test Case

{
  "project_key": "PROJ",
  "name": "Login Test"
}

Step-by-Step Test Case

{
  "project_key": "PROJ",
  "name": "User Login Flow",
  "test_script_type": "STEP_BY_STEP",
  "steps": [
    {
      "description": "Navigate to login page",
      "testData": "URL: https://app.example.com/login",
      "expectedResult": "Login form is displayed"
    }
  ]
}

BDD Test Case

{
  "project_key": "PROJ",
  "name": "User Authentication",
  "bdd_content": "**Given** a user with valid credentials\n**When** the user attempts to log in\n**Then** the user should be authenticated successfully"
}

Authentication

Get your API token from:

Atlassian account settings
Security → API tokens
Create new token for Zephyr Scale

License

MIT