🧪 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

🛠️ 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:

#	Test	Status
1	Update product quantity in cart	✅ Passed
2	Complete checkout after login	✅ Passed
3	nopCommerce homepage loads successfully	✅ Passed
4	Invalid login credentials	✅ Passed
5	Customer logout	✅ Passed
6	Add product to cart	✅ Passed
7	Remove product from cart	✅ Passed

🤖 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.