infy-mcp-playwright

MCP Playwright server for web app testing automation. Exposes an HTTP API to run Playwright tests (navigation, clicks, link checks, screenshots). This tool can be used for quick website validation, smoke testing, link validation, accessibility testing, performance checks, and basic SEO testing. It reduces the need to manually create a separate Playwright framework for every small testing requirement.

Install

npm install infy-mcp-playwright

Or install globally:

npm install -g infy-mcp-playwright

Start the server

Local project:

npm start

Global CLI:

infy-mcp-playwright

The server prints:

MCP Server Running on Port 3000

Set PORT to change the listen port (default: 3000). Set HEADLESS=false to open a visible browser window.

Health check

Verify the server is running without starting a browser test:

curl http://localhost:3000/health

Expected response:

{
  "status": "ok",
  "service": "infy-mcp-playwright"
}

Run a test request

curl -X POST http://localhost:3000/run-test \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://perfectqaservices.com",
    "checkLinks": {
      "selector": "a"
    }
  }'

Request body options

| Field | Description | |-------|-------------| | url | Page URL to open (required) | | steps | Array of user actions to run after the page loads (see below) | | type | { selector, value } — fill an input (legacy single-step shortcut) | | press | Keyboard key (e.g. "Enter") | | click | { selector } — click an element | | checkLinks | { selector } — visit each matching link and report status |

Multi-step actions

After the page loads, steps runs a real user flow. Each step is recorded in stepResults. If a step fails, the test stops and returns status: "failed" with the failed step.

| action | Fields | What it does | |----------|--------|--------------| | click | selector, optional timeout | Click an element | | type / fill | selector, value, optional timeout | Clear and type into an input | | press | key (or value), optional selector | Press a keyboard key | | wait | selector and/or timeout | Wait for an element, or wait a number of ms | | assertText | selector, text | Fail if the element does not contain text | | screenshot | optional name | Save a full-page screenshot under artifacts/ |

curl -X POST http://localhost:3000/run-test \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/login",
    "steps": [
      { "action": "type", "selector": "#email", "value": "[email protected]" },
      { "action": "type", "selector": "#password", "value": "secret" },
      { "action": "click", "selector": "button[type=submit]" },
      { "action": "wait", "selector": ".dashboard", "timeout": 10000 },
      { "action": "assertText", "selector": "h1", "text": "Welcome" },
      { "action": "screenshot", "name": "after-login" }
    ]
  }'

Programmatic API

const { runTest } = require('infy-mcp-playwright');

const result = await runTest({
  url: 'https://example.com',
  checkLinks: { selector: 'a' }
});

Enhanced checks and outputs

worker.js performs additional runtime checks and produces reports and artifacts automatically. Notable request options and outputs:

• Request body options:

  • browser: chromium|firefox|webkit — choose the engine (default: chromium).
  • headless: boolean — run with a visible browser when false (default: true).
  • mobile: boolean — emulate iPhone 13 when true.
  • darkMode: boolean — set page color scheme to dark when true.
  • slowMo: number — slow motion in ms for Playwright (default: 200).

• Runtime checks performed: performance metrics (dns, tcp, ttfb, dom/load times), memory usage, empty-page detection, infinite-loader detection (common loader selectors), basic SEO extraction (title, meta description, h1, canonical), broken images, console errors, page JS errors, failed requests and network failures (status >= 400), slow API detection (>5s), and accessibility scans via axe-core.

• Link checking: visits links matched by checkLinks.selector (default a) with up to 3 retries, captures a screenshot per visited page, and marks each as PASSED or FAILED.

• Artifacts & reports: saved under artifacts/, videos/, json-reports/ and reports/. The worker writes a JSON report (json-reports/report-<ts>.json) and an HTML report (reports/report-<ts>.html) and stores screenshots in artifacts/.

• Response object: the API returns a structured object containing status, browser, loadTime, performanceMetrics, memoryUsage, seo, totalPages, passed, failed, brokenImages, consoleErrors, jsErrors, failedRequests, networkFailures, slowApis, accessibilityIssues, stepResults, checkedPages, aiSummary, htmlReport, jsonReport, and screenshot (final screenshot path).

Example curl request using the new options:

curl -X POST http://localhost:3000/run-test \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "browser": "firefox",
    "headless": false,
    "mobile": false,
    "darkMode": true,
    "slowMo": 100,
    "checkLinks": { "selector": "a" }
  }'

Publish to npm

1. Log in: npm login
2. Dry-run: npm pack --dry-run
3. Publish: npm publish

License

ISC