Playwright MCP Server (with Video Recording)

This project runs a Model Context Protocol (MCP) server powered by Playwright, deployed as an Apify Actor. It enables browser automation, web page interaction, and video recording of browser sessions via the MCP protocol.

Features

• Playwright-powered MCP server: Automate Chromium browsers using the MCP protocol.
• Video recording: All browser sessions can be recorded and saved as video files.
• Headless mode: Runs browsers in headless mode for efficient automation.
• Customizable viewport: Set the browser viewport size for your use case.
• Runs on Apify platform: Monetize and scale your MCP server as an Apify Actor.

How it works

When the Actor starts, it launches the Playwright MCP server with video recording enabled. The MCP server listens for protocol requests and executes browser automation tasks, returning results and video recordings as needed.

Usage

The MCP server is started with the following command (see src/main.ts):

const MCP_COMMAND = [
    'npx',
    '@lewisvoncken/playwright-mcp',
    '--viewport-size=1280,800',
];

• --viewport-size=1280,800: Sets the browser window size.

Endpoints

Once deployed, your MCP server is accessible via the following endpoints:

• https://mrlewis--playwright-recorder-mcp.apify.actor/mcp (streamable HTTP transport, recommended)
• https://mrlewis--playwright-recorder-mcp.apify.actor/sse (legacy SSE transport)

Getting staretd

{
  "mcpServers": {
    "playwright": {
      "url": "https://mrlewis--playwright-recorder-mcp.apify.actor/mcp"
      "headers": {
          "Authorization": "Bearer <YOUR_APIFY_API_TOKEN>"
      }
    }
  }
}
``

## Resources

- [Playwright MCP server (npm)](https://www.npmjs.com/package/@lewisvoncken/playwright-mcp)
- [Model Context Protocol documentation](https://modelcontextprotocol.io)
- [Apify Platform documentation](https://docs.apify.com/platform)
- [Pay Per Event monetization](https://docs.apify.com/platform/actors/publishing/monetize#pay-per-event-pricing-model)

---

**This project is tailored for Playwright MCP with video recording. For questions or support, see the linked resources above.**