Playwright Wizard

Playwright Wizard MCP Server guides you through building a production-ready Playwright test suite with best-practice prompts, structured workflows, and reusable components. It helps you analyze your app, plan tests, set up infrastructure, generate page objects, and implement tests, all while offering optional enhancements like accessibility and API testing.

How to use

You interact with the Playwright Wizard MCP Server through an MCP client. Start by connecting your client to the server, then follow the guided workflow to analyze your application, define a test plan, set up infrastructure, generate page objects, and implement your tests. The server orchestrates each step, returns concrete artifacts, and keeps your project organized with a clear workflow folder.

How to install

Prerequisites you need before installation include Node.js version 18 or higher and an MCP-compatible client such as GitHub Copilot in VS Code, Claude Desktop, or Cline.

{
  "mcpServers": {
    "playwright-wizard": {
      "command": "npx",
      "args": ["-y", "playwright-wizard-mcp"]
    }
  }
}

If you prefer not to install locally every time, you can run the server on demand using npx, which fetches the latest version automatically.

{
  "mcpServers": {
    "playwright-wizard": {
      "command": "npx",
      "args": ["-y", "playwright-wizard-mcp"]
    }
  }
}

For faster startup with offline capability, you can install the package globally and configure the client to run the local binary.

npm install -g playwright-wizard-mcp

Then configure without npx using the local command.

{
  "mcpServers": {
    "playwright-wizard": {
      "command": "playwright-wizard-mcp"
    }
  }
}

Additional configurations and notes

The server can also be discovered via the MCP Registry for easy installation and discovery.

Configuration examples

If you are using a local setup with a standard MCP client, you may use the following configuration snippet to start the server via npx.

{
  "mcpServers": {
    "playwright-wizard": {
      "command": "npx",
      "args": ["-y", "playwright-wizard-mcp"]
    }
  }
}

Security and best practices

Keep your MCP client up to date to receive the latest security and feature updates. Use a project-scoped configuration to avoid accidental leakage of credentials and secrets. When using CI/CD, pin the server version and verify artifacts between runs.

Troubleshooting and notes

If the server does not respond as expected, verify that your MCP client is connected, the configuration is loaded, and you have network access to any required registries. Restart the client after any changes to the MCP configuration.

Getting started steps snapshot

1. Install or access the MCP server via your preferred method. 2. Open your MCP client and connect to the playwright-wizard server. 3. Start the guided workflow to analyze your application and generate the test suite scaffold.

Available tools

analyze-app

Analyzes your application structure and tech stack, producing project-config.md, pages.md, and selector-strategy.md to guide the test suite.

generate-test-plan

Creates comprehensive test scenarios and acceptance criteria, producing a test-plan.md with defined suites and flows.

setup-infrastructure

Sets up Playwright configuration, fixtures, and folder structure (playwright.config.ts, fixtures, helpers).

generate-page-objects

Generates type-safe page objects with accessible selectors and TypeScript types, placed under tests/pages.

implement-test-suite

Writes complete tests with assertions and error handling, enabling parallel execution and performance optimization.

setup-ci-cd

Adds CI/CD configuration (e.g., GitHub Actions) to automate running tests.

add-accessibility

Integrates accessibility checks (axe-core) and adds accessibility test helpers.

add-api-testing

Adds API testing capabilities for REST/GraphQL/tRPC endpoints alongside UI tests.

advanced-optimization

Provides patterns for advanced performance optimizations and auth state reuse.

reference-core-principles

Offers core testing principles and quality standards as reference guidance.

reference-workflow-overview

Gives a complete overview of the workflow and prompt relationships.

reference-mcp-setup

Presents MCP server setup and usage patterns for troubleshooting.

reference-selector-strategies

Presents selector best practices and HTML quality scoring guidance.

reference-fixture-patterns

Outlines fixture patterns for parallel execution and state management.

reference-data-storage-patterns

Guides test data storage approaches (ORM, JSON, MSW).