Playwright Wizard

Playwright Wizard

Step-by-step wizard for generating Playwright E2E tests with best practices.

1
Stars
1
Forks
6
Releases

Overview

Playwright Wizard MCP Server is an intelligent Model Context Protocol (MCP) server that guides you through building production-ready Playwright E2E test suites with best practices built in. It provides a structured, step-by-step wizard workflow with comprehensive prompts that cover analysis, test planning, infrastructure setup, page-object generation, and test implementation. The server emphasizes best practices for selectors, fixtures, and parallel execution, and offers optional enhancements for accessibility testing and API testing. It exposes a curated set of 15 tools organized into core workflow, optional enhancements, and reference documentation, which can be invoked to automate the entire testing lifecycle. When used in a project, it creates a complete test infrastructure, including a .playwright-wizard-mcp/ folder containing analysis artifacts (project-config.md, pages.md, selector-strategy.md, test-plan.md), a tests/ directory with page objects, fixtures, helpers, and spec files, and a Playwright configuration file (playwright.config.ts). It supports MCP Registry integration for easy discovery and installation and can run on-demand via npx or installed globally for offline startup. Prerequisites include Node.js 18+ and an MCP-compatible client (GitHub Copilot in VS Code, Claude Desktop, Cline, etc.).

Details

Owner
oguzc
Language
JavaScript
License
MIT License
Updated
2025-12-07

Features

Step-by-step wizard workflow

A guided, sequential process for creating production-ready Playwright test suites.

Comprehensive prompts

Prompts cover analysis, planning, setup, and implementation to shape the test strategy.

Best practices for selectors, fixtures, and parallel execution

Promotes robust selectors, maintainable fixtures, and efficient parallel test execution.

Optional enhancements for accessibility and API testing

Adds accessibility checks and API testing utilities to broaden test coverage.

Reference documentation

Provides core principles and workflow references to guide patterns and decisions.

MCP Registry integration

Enables easy discovery and installation of the server via the MCP Registry.

Tool suite of 15 tools

Exposes tools organized into core workflow, optional enhancements, and reference documentation to automate the lifecycle.

Audience

QA engineersUse to guide the creation of comprehensive Playwright E2E test suites with built-in best practices.
Software developersLeverage the wizard to accelerate test infrastructure setup and generate maintainable page objects and tests.
Testing teams / MCP usersIntegrate with the MCP Registry and standardize testing workflows across projects.

Tags

PlaywrightMCPwizardend-to-end testingtest automationpage objectsfixturesaccessibilityapi testingCI/CDregistry integrationworkflow