MCP-Server-Playwright

MCP.Pizza Chef: Automata-Labs-team

MCP-Server-Playwright is a Model Context Protocol server that empowers large language models to perform browser automation using the Playwright framework. It allows LLMs to interact with live web pages, execute JavaScript, take screenshots, and navigate complex web environments in a real browser context. This server bridges the gap between AI models and dynamic web content, enabling advanced automation, testing, and data extraction workflows. It supports secure, scoped interactions and integrates seamlessly into MCP ecosystems, enhancing AI capabilities with real-time web control.

Use This MCP server To

Automate web page interactions for testing or data entry Capture screenshots of web pages for documentation Execute custom JavaScript on live websites Navigate multi-step web workflows programmatically Extract structured data from dynamic web content Simulate user behavior for web automation tasks

README

MCP Server Playwright

MCP Playwright

A Model Context Protocol server that provides browser automation capabilities using Playwright
Enable LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment

NPM Version Downloads per month License Smithery Installs

MCP-Server-Playwright MCP server

Table of Contents

Features

  • 🌐 Full browser automation capabilities
  • 📸 Screenshot capture of entire pages or specific elements
  • 🖱️ Comprehensive web interaction (navigation, clicking, form filling)
  • 📊 Console log monitoring
  • 🔧 JavaScript execution in browser context

Installation

Installing via Smithery

To install MCP Server Playwright for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @automatalabs/mcp-server-playwright --client claude

You can install the package using either npx or mcp-get:

Using npx:

npx @automatalabs/mcp-server-playwright install

This command will:

  1. Check your operating system compatibility (Windows/macOS)
  2. Create or update the Claude configuration file
  3. Configure the Playwright server integration

The configuration file will be automatically created/updated at:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Using mcp-get:

npx @michaellatman/mcp-get@latest install @automatalabs/mcp-server-playwright

Configuration

The installation process will automatically add the following configuration to your Claude config file:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@automatalabs/mcp-server-playwright"]
    }
  }
}

Components

Tools

browser_navigate

Navigate to any URL in the browser

{
  "url": "https://stealthbrowser.cloud"
}

browser_screenshot

Capture screenshots of the entire page or specific elements

{
  "name": "screenshot-name",     // required
  "selector": "#element-id",     // optional
  "fullPage": true              // optional, default: false
}

browser_click

Click elements on the page using CSS selector

{
  "selector": "#button-id"
}

browser_click_text

Click elements on the page by their text content

{
  "text": "Click me"
}

browser_hover

Hover over elements on the page using CSS selector

{
  "selector": "#menu-item"
}

browser_hover_text

Hover over elements on the page by their text content

{
  "text": "Hover me"
}

browser_fill

Fill out input fields

{
  "selector": "#input-field",
  "value": "Hello World"
}

browser_select

Select an option in a SELECT element using CSS selector

{
  "selector": "#dropdown",
  "value": "option-value"
}

browser_select_text

Select an option in a SELECT element by its text content

{
  "text": "Choose me",
  "value": "option-value"
}

browser_evaluate

Execute JavaScript in the browser console

{
  "script": "document.title"
}

Resources

  1. Console Logs (console://logs)

    • Access browser console output in text format
    • Includes all console messages from the browser
  2. Screenshots (screenshot://<n>)

    • Access PNG images of captured screenshots
    • Referenced by the name specified during capture

License

This project is licensed under the MIT License - see the LICENSE file for details.

MCP-Server-Playwright FAQ

How do I install MCP-Server-Playwright?
Install via npm using 'npm install @automatalabs/mcp-server-playwright'.
Can MCP-Server-Playwright run headless browsers?
Yes, it supports headless and headed browser modes for automation.
Is it possible to execute JavaScript on web pages?
Yes, the server allows LLMs to run custom JavaScript within the browser context.
How does MCP-Server-Playwright ensure secure interactions?
It scopes browser automation commands securely within the MCP framework to prevent unauthorized actions.
Can I use MCP-Server-Playwright with different LLM providers?
Yes, it is provider-agnostic and works with OpenAI, Anthropic Claude, Google Gemini, and others.
Does it support capturing screenshots?
Yes, the server can take screenshots of web pages as part of automation workflows.
What browsers does MCP-Server-Playwright support?
It supports Chromium, Firefox, and WebKit browsers via Playwright.
How do I integrate MCP-Server-Playwright into my MCP client?
Connect the server endpoint in your MCP client configuration to enable browser automation capabilities.