qa-auto-stack

josemejias11/qa-auto-stack

3.2

If you are the rightful owner of qa-auto-stack and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Playwright MCP Server QA Automation Framework is a comprehensive testing solution that integrates traditional Playwright tests with AI-enhanced Model Context Protocol (MCP) testing and complete API validation.

Tools
1
Resources
0
Prompts
0

Playwright MCP Server

A modern, TypeScript-based Model Context Protocol (MCP) server for Playwright automation.

Features

  • Modular Playwright tools: inspect element, page interaction, screenshot, visual comparison, network/console inspector, accessibility checker, data extraction
  • TypeScript strictness and safety
  • ESLint and Prettier for code quality and formatting
  • Playwright Test for unit/integration testing
  • Typed environment config with dotenv
  • Dockerfile and Docker Compose for containerized deployment
  • Secure dependency management
  • Health and metrics endpoints for monitoring
  • Job-separated CI workflow: Lint, format, build, test, docker, and health-check jobs for fast, reliable automation
  • Playwright browser install in CI: Ensures all browser binaries are available for tests
  • Test scaffolding CLI: Scaffold Playwright tests for any page via npm run scaffold-test -- --url=<page-url>

Getting Started

Install dependencies

npm install

Build the project

npm run build

Start the MCP server

npm run start

Run tests

npm run test

Scaffold Playwright tests

Generate a test for any page:

npm run scaffold-test -- --url=https://google.com

Lint and format code

npm run lint
npm run lint:fix
npm run format
npm run format:check

Environment Variables

Copy .env.example to .env and set your values.

Docker

Build and run the container:

docker build -t playwright-mcp-server .
docker run -p 8081:8081 playwright-mcp-server

Docker Compose

Start with Docker Compose:

docker-compose up --build

CI/CD

CI workflow runs lint, format, build, test (with Playwright browser install), docker, and health-check jobs in parallel and sequence for fast feedback and reliability.

Endpoints

  • Health: http://localhost:8081/health
  • Metrics: http://localhost:8081/metrics

Project Structure

  • src/ - TypeScript source files
  • build/ - Compiled output
  • .env.example - Example environment config
  • Dockerfile & .dockerignore - Container setup
  • docker-compose.yml - Multi-container orchestration

License

MIT