Skip to main content
Glama

Playwright MCP Server

by nolecram

Playwright MCP Server

Python 3.8+ License: MIT MCP Server

A powerful Model Context Protocol (MCP) server that provides comprehensive browser automation capabilities using Playwright. This server enables AI assistants to interact with web pages, perform automated testing, web scraping, and complex browser-based workflows.

๐Ÿš€ Quick Install for VSCode

Install this MCP server directly in VSCode with one click:

Install in VSCode

โœจ Features

  • ๐ŸŒ Complete Browser Control: Navigate, click, type, and interact with any web element

  • ๐Ÿ“ธ Screenshot & Visual Testing: Capture full pages or specific elements

  • ๐Ÿ”„ Tab Management: Open, close, and switch between multiple browser tabs

  • ๐Ÿ“ Form Automation: Fill forms, select options, handle checkboxes and radio buttons

  • โณ Smart Waiting: Wait for elements, network requests, or specific page states

  • ๐Ÿ” Content Extraction: Get text, attributes, and data from web pages

  • ๐Ÿ’ป JavaScript Execution: Run custom JavaScript in the browser context

  • ๐Ÿ›ก๏ธ Robust Error Handling: Comprehensive error handling with meaningful messages

๐Ÿ“ฆ Installation

Prerequisites

  • Python 3.8 or higher

  • Node.js (required for Playwright browser installation)

Install from PyPI

pip install playwright-mcp-server playwright install chromium

Install from Source

git clone https://github.com/nolecram/Build_MCP_Server.git cd Build_MCP_Server pip install -e . playwright install chromium

๐Ÿ”ง Configuration

For MCP Clients

Add to your MCP client configuration:

{ "mcpServers": { "playwright": { "command": "playwright-mcp-server", "args": [] } } }

For VSCode MCP Extension

Add to your VSCode settings:

{ "mcp.servers": { "playwright": { "command": "playwright-mcp-server" } } }

๐Ÿ› ๏ธ Available Tools

Tool

Description

Parameters

browser_navigate

Navigate to a URL

url

browser_click

Click on an element

selector

,

timeout?

browser_type

Type text into an element

selector

,

text

,

timeout?

browser_screenshot

Take a screenshot

path?

,

full_page?

browser_get_text

Extract text from an element

selector

,

timeout?

browser_wait_for_selector

Wait for element to appear

selector

,

timeout?

,

state?

browser_evaluate

Execute JavaScript

script

browser_new_tab

Open a new tab

url?

browser_close_tab

Close current tab

-

browser_get_title

Get page title

-

browser_get_url

Get current URL

-

๐Ÿ’ก Usage Examples

Web Scraping

# Navigate to a website browser_navigate {"url": "https://example.com"} # Wait for content to load browser_wait_for_selector {"selector": ".content"} # Extract information browser_get_text {"selector": ".price"} # Take a screenshot browser_screenshot {"full_page": true}

Form Automation

# Fill out a form browser_type {"selector": "#email", "text": "user@example.com"} browser_type {"selector": "#password", "text": "secretpassword"} browser_click {"selector": "#login-button"}

Testing Workflows

# Multi-step testing browser_navigate {"url": "https://app.example.com"} browser_click {"selector": "#feature-button"} browser_wait_for_selector {"selector": ".success-message"} browser_screenshot {"path": "test-result.png"}

๐Ÿงช Testing

Run the test suite:

# Install test dependencies pip install pytest pytest-asyncio # Run tests pytest tests/ # Run with coverage pytest --cov=playwright_mcp_server tests/

๐Ÿ“š Documentation

Comprehensive documentation is available in the docs directory:

๐Ÿ”’ Security

  • Runs in headless mode by default

  • Isolated browser contexts for each session

  • Automatic resource cleanup

  • Configurable timeout limits

  • No sensitive data logging

๐Ÿค Contributing

We welcome contributions! Please see our contributing guidelines:

  1. Fork the repository

  2. Create a feature branch

  3. Add tests for your changes

  4. Ensure all tests pass

  5. Submit a pull request

๐Ÿ“„ License

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

๐Ÿ™ Acknowledgments

  • Built with Playwright for reliable browser automation

  • Implements the Model Context Protocol specification

  • Inspired by the need for robust browser automation in AI workflows

๐Ÿ“ˆ Roadmap

  • Support for multiple browser engines (Firefox, Safari)

  • Advanced element selection strategies

  • Built-in visual regression testing

  • Performance monitoring and metrics

  • Browser extension interaction

  • Mobile browser simulation


โญ Star this repository if you find it useful!

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

A Model Context Protocol server that enables AI assistants to interact with web pages through browser automation, supporting web scraping, form filling, navigation, and other browser-based tasks using Playwright.

  1. ๐Ÿš€ Quick Install for VSCode
    1. โœจ Features
      1. ๐Ÿ“ฆ Installation
        1. Prerequisites
        2. Install from PyPI
        3. Install from Source
      2. ๐Ÿ”ง Configuration
        1. For MCP Clients
        2. For VSCode MCP Extension
      3. ๐Ÿ› ๏ธ Available Tools
        1. ๐Ÿ’ก Usage Examples
          1. Web Scraping
          2. Form Automation
          3. Testing Workflows
        2. ๐Ÿงช Testing
          1. ๐Ÿ“š Documentation
            1. ๐Ÿ”’ Security
              1. ๐Ÿค Contributing
                1. ๐Ÿ“„ License
                  1. ๐Ÿ™ Acknowledgments
                    1. ๐Ÿ“ˆ Roadmap

                      Related MCP Servers

                      • -
                        security
                        F
                        license
                        -
                        quality
                        Provides a server utilizing Model Context Protocol to enable human-like browser automation with Playwright, allowing control over browser actions such as navigation, element interaction, and scrolling.
                        Last updated -
                        7
                      • A
                        security
                        A
                        license
                        A
                        quality
                        A Model Context Protocol server that provides browser automation capabilities using Playwright, enabling LLMs to interact with web pages, take screenshots, generate test code, scrape web content, and execute JavaScript in real browser environments.
                        Last updated -
                        31
                        8,548
                        MIT License
                        • Linux
                        • Apple
                      • A
                        security
                        F
                        license
                        A
                        quality
                        A Model Context Protocol server that enables AI assistants to interact with web browsers through Playwright, providing automation capabilities for navigation, interaction, and screenshots.
                        Last updated -
                        14
                        3
                        • Linux
                      • A
                        security
                        F
                        license
                        A
                        quality
                        A Model Context Protocol server that provides browser automation capabilities using Playwright, enabling AI assistants to interact with web pages through a standardized interface.
                        Last updated -
                        14
                        3
                        • Linux

                      View all related MCP servers

                      MCP directory API

                      We provide all the information about MCP servers via our MCP API.

                      curl -X GET 'https://glama.ai/api/mcp/v1/servers/nolecram/Build_MCP_Server'

                      If you have feedback or need assistance with the MCP directory API, please join our Discord server