automation-script-generator

raymondsambur/automation-script-generator

3.2

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

The Automation Script Generator MCP Server is a sophisticated tool designed to streamline the creation of automated test scripts using the WDIO framework. It processes user prompts to generate complete test suites with intelligent file management, ensuring organized and efficient test structures.

Tools
7
Resources
0
Prompts
0

Automation Script Generator

🚀 Project Mission: Hybrid AI Automation Framework (Notion -> Playwright)

This project creates an autonomous end-to-end testing framework that bridges the gap between manual test case management and automated execution. It leverages Generative AI to automatically generate robust Playwright test scripts from Notion test tickets.

🎯 Objectives

  1. Read: Fetch test scenarios directly from a Notion Database.
  2. Generate: Create executable Playwright (TypeScript) scripts automatically using Google Gemini.
  3. Execute: Run tests with a "Self-Healing" mechanism for resilient locators.
  4. Report: Generate detailed reports via Allure and reflect status updates back to Notion.

🛠️ Tech Stack

  • Language: TypeScript, Node.js (v20+)
  • Framework: Playwright
  • AI Model: Google Gemini (gemini-2.0-flash via @google/genai SDK)
  • Integration: Notion API (@notionhq/client)
  • Reporting: Allure Report

📂 Directory Structure

/
├── .agent/rules/             # Antigravity context rules
├── config/                   # Configuration files
│   └── notion.config.ts      # Notion API keys and DB IDs
├── src/
│   ├── generator/            # THE BUILDER
│   │   ├── fetcher.ts        # Pulls from Notion
│   │   ├── translator.ts     # Gemini Agent (Notion -> TS Code)
│   │   └── writer.ts         # Saves .spec.ts files
│   ├── framework/            # THE RUNNER
│   │   ├── pages/            # Page Objects (POM)
│   │   └── actions/          # Self-healing wrappers
│   └── tests/                # Generated Spec files live here
├── playwright.config.ts
├── .env                      # Contains API Keys
└── package.json

⚙️ Setup & Installation

  1. Clone the repository:

    git clone <repository-url>
cd automation-script-generator

  2. Install dependencies:

    npm install

  3. Environment Configuration: Create a .env file in the root directory and add your keys:

    GEMINI_API_KEY=your_google_gemini_api_key
NOTION_TOKEN=your_notion_integration_token
NOTION_DATABASE_ID=your_notion_database_id

🏃 Usage

1. Generate Tests

To fetch "Ready for Automation" tickets from Notion and generate Playwright test files with strict Page Object Model separation:

npx ts-node src/generator/main.ts
  • Artifacts:
    • src/framework/pages/*.page.ts: Page Objects (private selectors, public methods).
    • src/tests/[module]/[module].data.ts: Shared test data per module.
    • src/tests/[module]/[id]...spec.ts: Clean test specs.

2. Run Tests

To execute the generated Playwright tests:

npm test
  • Video: Recorded for ALL runs (available in Allure report).
  • Screenshots: Captured only on failure.

3. View Reports

To generate and view the Allure test report:

npm run test:report   # Generates report (cleans old results)
npm run test:open     # Opens report in browser

🧠 Smart Actions (Self-Healing)

The framework includes a SmartPage wrapper that handles flaky selectors. If a primary selector fails, it attempts to "heal" by using fallback strategies (like text hints) and logs the event, preventing brittle test failures.