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

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.

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": "user@test.com" },
      { "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 (com

... View full README on GitHub