Krayin5 Automated Tests MCP Server

A Model Context Protocol (MCP) server that connects to and manages the parent Krayin5 automated testing infrastructure.

Overview

This MCP server provides a bridge to the parent krayin5-automated-tests project, offering tools for:

• Real Test Execution: Run actual Cucumber.js + Playwright tests

• Live Status Monitoring: Check current test status and reports

• Feature Discovery: Browse actual .feature files and test scenarios

• Coverage Analysis: Analyze test reports and coverage data

Related MCP server: tuxedo-qa

Connection to Parent Project

This MCP server is connected to: ../krayin5-automated-tests

Parent Project Structure:

• Framework: Cucumber.js + Playwright + TypeScript

• Features: Authentication, Contact Management, Organization Management

• Test Types: Smoke, Contact, Organization, Auth, Headless

• Reports: JSON reports generated in reports/ directory

• Screenshots: Debug screenshots saved in screenshots/ directory

Features

Available Tools

1. get_test_status - Get real-time status of the parent test project

2. run_test_suite - Execute actual test suites from parent project

3. get_test_coverage - Analyze actual test reports and coverage

4. list_krayin_test_cases - Browse real feature files and available test suites

Real Test Suites Available

• all: Run all tests (npm test)

• smoke: Run smoke tests (npm run test:smoke)

• contacts: Run contact management tests (npm run test:contacts)

• organization: Run organization tests (npm run test:organization)

• auth: Run authentication tests (npm run test:auth)

• headless: Run tests in headless mode (npm run test:headless)

Installation

1. Clone this repository

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

Usage

With Claude Desktop

Add this server to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "krayin5-automated-tests": {
      "command": "node",
      "args": ["/Users/lucascortazzo/code/mcp-krayin5-automated-tests/build/index.js"]
    }
  }
}

Direct Usage

Run the server directly:

npm start

Development

• Build: npm run build

• Development: npm run dev (builds and runs)

• Start: npm start (runs pre-built version)

MCP Integration

This server implements the Model Context Protocol specification and can be used with any MCP-compatible client, including:

• Claude Desktop

• VS Code with MCP extensions

• Custom MCP clients

Project Structure

├── src/
│   └── index.ts          # Main MCP server implementation
├── build/                # Compiled JavaScript (generated)
├── .github/
│   └── copilot-instructions.md
├── .vscode/
│   └── mcp.json         # VS Code MCP configuration
├── package.json
├── tsconfig.json
└── README.md

Contributing

1. Make changes to TypeScript source files in src/

2. Build the project with npm run build

3. Test with your MCP client

4. Ensure all TypeScript compilation passes without errors

License

ISC