MCP-Server-Playwright

npmGitHub
  • Browser Automation
JavaScript
MIT
102
16
  • Apple
A
security – no known vulnerabilities (report Issue)
A
license - permissive license (MIT)
A
quality - confirmed to work

Enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment

  1. Tools
  2. Prompts
  3. Resources
  4. Server Configuration
  5. README.md

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription
Browser console logs

Tools

Functions exposed to the LLM to take actions

NameDescription
playwright_navigateNavigate to a URL
playwright_screenshotTake a screenshot of the current page or a specific element
playwright_clickClick an element on the page using CSS selector
playwright_click_textClick an element on the page by its text content
playwright_fillFill out an input field
playwright_selectSelect an element on the page with Select tag using CSS selector
playwright_select_textSelect an element on the page with Select tag by its text content
playwright_hoverHover an element on the page using CSS selector
playwright_hover_textHover an element on the page by its text content
playwright_evaluateExecute JavaScript in the browser console

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Need Help?View Source CodeReport Issue
README.md
<h1 align="center">MCP Server Playwright</h1> <p align="center"> <a href="https://www.automatalabs.io"><img alt="MCP Playwright" src="https://automatalabs.io/icon.svg" height="250"/></a> </p> <p align="center"> <b>A Model Context Protocol server that provides browser automation capabilities using Playwright</b></br> <sub>Enable LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment</sub> </p> <p align="center"> <a href="https://www.npmjs.com/package/@automatalabs/mcp-server-playwright"><img alt="NPM Version" src="https://img.shields.io/npm/v/@automatalabs/mcp-server-playwright.svg" height="20"/></a> <a href="https://npmcharts.com/compare/@automatalabs/mcp-server-playwright?minimal=true"><img alt="Downloads per month" src="https://img.shields.io/npm/dm/@automatalabs/mcp-server-playwright.svg" height="20"/></a> <a href="https://github.com/Automata-Labs-team/MCP-Server-Playwright/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/github/license/Automata-Labs-team/MCP-Server-Playwright.svg" height="20"/></a> <a href="https://smithery.ai/protocol/@automatalabs/mcp-server-playwright"><img alt="Smithery Installs" src="https://smithery.ai/badge/@automatalabs/mcp-server-playwright" height="20"/></a> </p>

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 @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

playwright_navigate

Navigate to any URL in the browser

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

playwright_screenshot

Capture screenshots of the entire page or specific elements

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

playwright_click

Click elements on the page using CSS selector

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

playwright_click_text

Click elements on the page by their text content

{ "text": "Click me" }

playwright_hover

Hover over elements on the page using CSS selector

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

playwright_hover_text

Hover over elements on the page by their text content

{ "text": "Hover me" }

playwright_fill

Fill out input fields

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

playwright_select

Select an option in a SELECT element using CSS selector

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

playwright_select_text

Select an option in a SELECT element by its text content

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

playwright_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.

GitHub Badge

Glama performs regular codebase and documentation scans to:

  • Confirm that the MCP server is working as expected.
  • Confirm that there are no obvious security issues with dependencies of the server.
  • Extract server characteristics such as tools, resources, prompts, and required parameters.

Our directory badge helps users to quickly asses that the MCP server is safe, server capabilities, and instructions for installing the server.

Copy the following code to your README.md file:

Alternative MCP servers

  • mcp-server-browserbase

    -
    security
    F
    license
    -
    quality
    This server provides cloud browser automation capabilities using Browserbase, Puppeteer, and Stagehand. This server enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a cloud browser environment.

  • mcp-webresearch

    -
    security
    A
    license
    -
    quality
    A Model Context Protocol (MCP) server for web research. Bring real-time info into Claude and easily research any topic.
    MIT
    • Apple

  • mcp-server-rag-web-browser official

    A
    security
    A
    license
    A
    quality
    Implementation of an MCP server for the RAG Web Browser Actor. This Actor serves as a web browser for large language models (LLMs) and RAG pipelines, similar to a web search in ChatGPT.
    Apache-2.0
    • Apple