playwright-wizard

Playwright Wizard MCP Server provides a guided, step-by-step workflow to create a production-ready Playwright test suite. It exposes a curated set of tools organized into core workflow, optional enhancements, and reference documentation to help you analyze your app, plan tests, generate infrastructure, create page objects, and implement the full test suite. You can invoke these tools through your MCP client (Copilot, Claude, Cline, or other MCP-enabled AI client) to generate artifacts like project configurations, test plans, fixtures, and test files, all aligned with best practices for selectors, parallel execution, accessibility, and API testing when needed. Start with analysis, move through planning and infrastructure setup, then generate page objects and implement tests, optionally adding CI/CD, accessibility checks, or API testing support as you go.

Prerequisites:

• Node.js 18 or higher
• npm (comes with Node)
• An MCP-compatible client (e.g., Copilot, Claude Desktop, Cline, etc.) for interacting with MCP servers

Installation options:

1. Quick Start (on-demand, no local install):

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

2. Global installation (faster startup, offline use):

npm install -g playwright-wizard-mcp

Configure without npx:

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

3. From MCP Registry (optional):

Visit the MCP Registry page for installation details and discovery: https://registry.modelcontextprotocol.io/v0/servers?search=playwright-wizard-mcp

Prerequisites for the server are satisfied by having Node.js 18+ and an MCP client; after installation, you can start using the Playwright Wizard tools through your MCP client.

Tips and notes:

• The server is accessed via MCP clients that support stdio-based tool interactions; ensure your client can discover and load the server configuration from your mcp.json or equivalent.
• The Quick Start uses the latest version of the package automatically via npx; if you need a fixed version, specify it in the command (e.g., playwright-wizard-mcp@1.2.3).
• When using global installation, you may want to pin the version to avoid breaking changes after updates.
• The Available Tools section lists core workflow steps (analyze-app, generate-test-plan, setup-infrastructure, generate-page-objects, implement-test-suite), optional enhancements (setup-ci-cd, add-accessibility, add-api-testing, advanced-optimization), and reference documentation for best practices.
• For VS Code Copilot, Claude Desktop, or Cline integrations, follow the respective configuration steps in the README to expose the Playwright Wizard tools in your editor or chat client.