Skip to main content
Glama
quotows

Playwright MCP

by quotows
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

Playwright MCP

An MCP server that gives compatible clients structured control of a real Playwright browser for QA, scraping diagnostics, accessibility-minded inspection, and reproducible browser workflows.

Architecture

Transport entrypoints are thin:

  • src/index.ts starts MCP over stdio.

  • src/http.ts starts MCP over Streamable HTTP.

  • src/server.ts builds one McpServer and registers all tools.

Core services own browser state:

  • BrowserManager serializes tool execution, launches browsers lazily, and manages contexts/pages.

  • TelemetryStore captures console messages, page errors, failed requests, and recent network events.

  • Tool modules register focused actions and depend only on the public browser/session APIs.

Tool groups:

  • Browser/context/page lifecycle

  • Navigation and waiting

  • Interaction

  • Inspection and screenshots

  • Assertions

  • Diagnostics, tracing, and storage

Related MCP server: Playwright Server MCP

Install

npm install
npm run install-browsers
npm run build

Run

npm start

HTTP transport:

npm run start:http

Default HTTP endpoint: http://127.0.0.1:8931/mcp.

Production Controls

Configuration is environment-driven:

  • PLAYWRIGHT_MCP_HTTP_TOKEN: require Authorization: Bearer <token> for HTTP mode.

  • PLAYWRIGHT_MCP_HTTP_ALLOWED_ORIGINS: comma-separated CORS allowlist.

  • PLAYWRIGHT_MCP_ALLOWED_ORIGINS: comma-separated browser navigation allowlist.

  • PLAYWRIGHT_MCP_BLOCKED_ORIGINS: comma-separated browser navigation blocklist.

  • PLAYWRIGHT_MCP_ALLOW_EVALUATE: enable the dangerous evaluate tool. Default: false.

  • PLAYWRIGHT_MCP_ALLOW_DOWNLOADS: enable download tools and accepting downloads. Default: false.

  • PLAYWRIGHT_MCP_ALLOW_UPLOADS: enable upload tools. Default: false.

  • PLAYWRIGHT_MCP_ARTIFACT_DIR: screenshots, traces, PDFs, downloads, and storage state directory. Default: ./artifacts.

  • PLAYWRIGHT_MCP_MAX_CONTEXTS: browser context cap. Default: 8.

  • PLAYWRIGHT_MCP_MAX_PAGES: page cap. Default: 32.

  • PLAYWRIGHT_MCP_DEFAULT_TIMEOUT_MS: default Playwright timeout. Default: 30000.

  • PLAYWRIGHT_MCP_LOG_LEVEL: debug, info, warn, or error.

HTTP mode should use PLAYWRIGHT_MCP_HTTP_TOKEN before binding to anything other than localhost.

MCP client config

Examples are available in examples/:

  • claude_config.json

  • cursor_mcp.json

  • codex_config.toml

  • cline_mcp_settings.json

  • opencode_config.json

Development

npm run check

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Playwright Server

    williamvd4
    A
    license
    B
    quality
    Not graded
    maintenance
    A MCP server that provides browser automation tools, allowing users to navigate websites, take screenshots, click elements, fill forms, and execute JavaScript through Playwright.
    8
    2
    Apache 2.0

  • Playwright Server MCP

    ziux
    A
    license
    B
    quality
    D
    maintenance
    A browser automation server providing Playwright capabilities for controlling web browsers, capturing screenshots, extracting content, and performing complex interactions through an MCP interface.
    6
    Apache 2.0

  • browser-mcp-server

    ricardodeazambuja
    A
    license
    B
    quality
    D
    maintenance
    A universal browser automation MCP server using Playwright, enabling programmatic control of Chrome with 63 tools for navigation, interaction, media control, and CDP-based diagnostics.
    63
    9 npm
    3
    MIT