{"id":31684526,"url":"https://github.com/oguzc/playwright-wizard-mcp","last_synced_at":"2025-10-08T08:11:23.974Z","repository":{"id":318574880,"uuid":"1071867957","full_name":"oguzc/playwright-wizard-mcp","owner":"oguzc","description":"MCP server providing Playwright test generation wizard with intelligent prompts and best practices","archived":false,"fork":false,"pushed_at":"2025-10-08T00:00:15.000Z","size":65,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-08T01:24:56.555Z","etag":null,"topics":["e2e-testing","mcp","model-context-protocol","playwright","test-automation","testing","typescript"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oguzc.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-07T23:38:26.000Z","updated_at":"2025-10-08T00:06:57.000Z","dependencies_parsed_at":"2025-10-08T01:24:59.982Z","dependency_job_id":null,"html_url":"https://github.com/oguzc/playwright-wizard-mcp","commit_stats":null,"previous_names":["oguzc/playwright-wizard-mcp"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/oguzc/playwright-wizard-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oguzc%2Fplaywright-wizard-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oguzc%2Fplaywright-wizard-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oguzc%2Fplaywright-wizard-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oguzc%2Fplaywright-wizard-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oguzc","download_url":"https://codeload.github.com/oguzc/playwright-wizard-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oguzc%2Fplaywright-wizard-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278909744,"owners_count":26066897,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["e2e-testing","mcp","model-context-protocol","playwright","test-automation","testing","typescript"],"created_at":"2025-10-08T08:09:32.206Z","updated_at":"2025-10-08T08:11:23.969Z","avatar_url":"https://github.com/oguzc.png","language":"JavaScript","funding_links":[],"categories":["📦 Other"],"sub_categories":[],"readme":"# Playwright Wizard MCP Server\n\n\u003e 🧙‍♂️ An intelligent Model Context Protocol (MCP) server that guiAll workflow documentation files are created in `.playwright-wizard-mcp/`:\n\n- `project-config.md` - Detected tech stack\n- `pages.md` - Page analysis with DOM quality scores\n- `selector-strategy.md` - Selector approach per page\n- `test-plan.md` - Test suites with progress tracking\n\n\u003e **Note:** The `.playwright-wizard-mcp/` folder is for workflow tracking only. You may want to add it to `.gitignore`.ough creating professional Playwright test suites with best practices built in.\n\n[![npm version](https://img.shields.io/npm/v/playwright-wizard-mcp.svg)](https://www.npmjs.com/package/playwright-wizard-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## Overview\n\nPlaywright Wizard MCP provides a structured, step-by-step approach to building comprehensive E2E test suites. Instead of starting from scratch or copying boilerplate, this MCP server guides you through industry best practices with intelligent prompts tailored to your application.\n\n## Features\n\n- 🧙‍♂️ **Step-by-step wizard workflow** for creating comprehensive test suites\n- 📚 **Comprehensive prompts** covering analysis, planning, setup, and implementation\n- 🎯 **Best practices** for selectors, fixtures, and parallel execution\n- 🔧 **Optional enhancements** for accessibility and API testing\n- 📖 **Reference documentation** for advanced patterns\n\n## Installation\n\n```bash\nnpm install -g playwright-wizard-mcp\n```\n\nOr install locally:\n\n```bash\nnpm install playwright-wizard-mcp\n```\n\n## Usage\n\n### Claude Desktop Configuration\n\nAdd to your Claude Desktop config file:\n\n**MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"playwright-wizard\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"playwright-wizard-mcp\"]\n    }\n  }\n}\n```\n\n### VS Code / Cline Configuration\n\nAdd to your MCP settings:\n\n```json\n{\n  \"playwright-wizard\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"playwright-wizard-mcp\"]\n  }\n}\n```\n\n## Available Prompts\n\n### Core Wizard Flow\n\n1. **analyze-app** - Analyze application structure and create test strategy\n2. **generate-test-plan** - Generate comprehensive test plan with scenarios\n3. **setup-infrastructure** - Setup Playwright infrastructure with fixtures and config\n4. **generate-page-objects** - Generate page object models with optimal selectors\n5. **implement-test-suite** - Implement complete test suite with best practices\n6. **review-and-optimize** - Review and optimize test suite for quality and performance\n\n### Optional Enhancements\n\n- **add-accessibility** - Add accessibility testing to existing suite\n- **add-api-testing** - Add API testing capabilities to test suite\n\n### Reference Documentation\n\n- **reference/core-principles** - Core testing principles that guide all implementations\n- **reference/workflow-overview** - High-level workflow guide and prompt relationships\n- **reference/mcp-setup** - MCP setup and usage patterns\n- **reference/selector-strategies** - Selector strategies and HTML quality scoring\n- **reference/fixture-patterns** - Playwright fixture patterns for parallel execution\n\n## Example Workflow\n\nUse the prompts in sequence to build a complete test suite:\n\n```\n1. Use \"analyze-app\" prompt to understand your application\n2. Use \"generate-test-plan\" to create test scenarios\n3. Use \"setup-infrastructure\" to configure Playwright\n4. Use \"generate-page-objects\" to create page models\n5. Use \"implement-test-suite\" to write tests (repeat for each suite)\n6. Use \"review-and-optimize\" to finalize\n```\n\nAll workflow documentation files are created in `.playwright-wizard-mcp/` folder in your project root:\n- `project-config.md` - Detected tech stack\n- `pages.md` - Page analysis with DOM quality scores\n- `selector-strategy.md` - Selector approach per page\n- `test-plan.md` - Test suites with progress tracking\n\n\u003e **Note:** The `.playwright-wizard-mcp/` folder is for workflow tracking only. You may want to add it to `.gitignore`.\n\n## Tools\n\n- **get-architecture** - Get the prompt architecture documentation\n\n## Requirements\n\n- Node.js \u003e= 18\n- MCP-compatible client (Claude Desktop, Cline, etc.)\n\n## Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/oguzc/playwright-wizard-mcp.git\ncd playwright-wizard-mcp\n\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Run in development mode\nnpm run dev\n```\n\n## License\n\nMIT\n\n## Contributing\n\nContributions welcome! Please open an issue or PR.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foguzc%2Fplaywright-wizard-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foguzc%2Fplaywright-wizard-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foguzc%2Fplaywright-wizard-mcp/lists"}