🧪 nopCommerce QA Automation + MCP

A professional QA Automation project built with Playwright, TypeScript, Node.js, and Model Context Protocol (MCP) to automate end-to-end testing and provide structured QA reports, test history, failure analysis, and dashboards.

🚀 Project Overview

This project combines Playwright automation with an MCP server that allows QA tests to be executed and analyzed through dedicated automation tools.

Architecture

QA Engineer
     │
     ▼
MCP Inspector
     │
     ▼
MCP Server
     │
     ├── Run Tests
     ├── Test Summary
     ├── Test Details
     ├── QA Report
     ├── Test History
     ├── Failure Analysis
     └── QA Dashboard
     │
     ▼
Playwright
     │
     ▼
nopCommerce

Related MCP server: mcp-playwright-test

🛠️ Tech Stack

• Playwright

• TypeScript

• Node.js

• MCP (Model Context Protocol)

• MCP Inspector

• JSON Test Reporting

• GitHub Actions

• End-to-End Testing

🧪 Automated Tests

The project currently contains 7 automated Playwright tests:

🤖 MCP QA Tools

The MCP server provides dedicated tools for interacting with the Playwright test suite:

• run_tests — Run the complete Playwright test suite

• test_summary — Display test names and statuses

• test_details — Display detailed information for a test

• qa_report — Generate a complete QA automation report

• test_history — Track previous test executions

• failure_analysis — Analyze failed and timed-out tests

• qa_dashboard — Display the latest QA dashboard

• run_test — Run a specific Playwright test

• list_tests — List available automated tests

• run_all_and_dashboard — Execute all tests and generate a dashboard

• run_failed_tests — Re-run failed tests

• compare_test_runs — Compare recorded test executions

📊 Latest Test Results

QA AUTOMATION DASHBOARD

Total Tests: 7
Passed: 7
Failed: 0
Skipped: 0
Flaky: 0

Pass Rate: 100%

Status: ALL TESTS PASSED

Execution Time: ~50 seconds

📁 Project Structure

nopcommerce-qa-mcp/
│
├── .github/
│   └── workflows/
│       └── playwright.yml
│
├── mcp/
│   └── server.ts
│
├── tests/
│   ├── cart.spec.ts
│   ├── checkout.spec.ts
│   ├── example.spec.ts
│   ├── login.spec.ts
│   ├── logout.spec.ts
│   ├── products.spec.ts
│   └── remove-from-cart.spec.ts
│
├── playwright.config.ts
├── package.json
├── package-lock.json
├── tsconfig.json
└── .gitignore

▶️ Run the Tests

Install dependencies:

npm install

Run all Playwright tests:

npx playwright test

Run tests with the line reporter:

npx playwright test --reporter=line

Run TypeScript validation:

npx tsc --noEmit

📋 Test Reporting

Playwright generates a JSON test report used by the MCP server for test analysis and dashboards.

The report contains:

• Test names

• Test files

• Pass/Fail status

• Execution duration

• Test output

• Errors

• Test execution timestamps

Generated test results are intentionally excluded from Git using .gitignore.

🔄 CI/CD

The project includes a GitHub Actions workflow for Playwright testing.

GitHub Push
     │
     ▼
GitHub Actions
     │
     ▼
Install Dependencies
     │
     ▼
Run Playwright Tests
     │
     ▼
Test Results

🎯 QA Capabilities

This project demonstrates practical experience with:

• End-to-End Testing

• UI Automation

• Test Automation Architecture

• Test Reporting

• Test Result Analysis

• Failure Analysis

• Test History Tracking

• Automated Regression Testing

• CI/CD Testing

• MCP-based QA tooling

🔐 Security

The project excludes sensitive and generated files such as:

node_modules/
test-results/
playwright-report/
.env
nopCommerce-develop/

👨‍💻 Author

Omar Aljerbi

QA Automation Engineer | Cloud & Automation

GitHub: https://github.com/Omar-Aljerbi

⭐ If you find this project useful, feel free to explore the repository.