Playwright MCP Configuration

Name: Playwright MCP Server
Author: faruklmu17

This repository contains everything needed to launch and connect to a working Playwright MCP (Model Context Protocol) server.

✅ Overview

This setup allows you to automate and inspect web pages using structured data instead of screenshots — ideal for LLM-powered tools like Claude, Cursor, and VS Code AI agents.

🛠️ Prerequisites

Node.js v18 or newer
One of the following MCP-compatible clients:
- VS Code or VS Code Insiders
- Cursor
- Claude Desktop

📁 Repository Contents

.vscode/settings.json — VS Code configuration to launch Playwright MCP
package.json — Includes required MCP dependencies
README.md — This file
.gitignore — Basic Node project ignore rules

🚀 Getting Started

1. Clone the Repository

git clone https://github.com/faruklmu17/playwright_mcp.git cd playwright-mcp-config

2. Install Dependencies

npm install

This installs all required packages, including @playwright/mcp.

3. Start the MCP Server

npx playwright-mcp --port 3550

You should see output like:

MCP Server started Web server started

You can change the port if needed, e.g. --port=4000

4. VS Code MCP Client Configuration

Add this to your .vscode/settings.json:

{ "mcpServers": { "playwright": { "command": "npx", "args": [ "@playwright/mcp@latest", "--port=3550" ] } } }

This tells VS Code (or Cursor) how to launch and connect to the MCP server.

5. Optional: Use Persistent or Isolated Sessions

Persistent (default)

The browser state is preserved across sessions.

Isolated Example

{ "mcpServers": { "playwright": { "command": "npx", "args": [ "@playwright/mcp@latest", "--isolated", "--storage-state=storage/state.json" ] } } }

6. Additional Flags

You can enhance your MCP server using optional flags:

Flag	Description
`--port <port>`	Custom port (default is random/OS-assigned)
`--headless`	Run without browser UI
`--device`	Emulate a device (e.g., "iPhone 15")
`--vision`	Enable screenshot-based vision (if supported)

Check available flags with:

npx playwright-mcp --help

📅 Note About Browsers

You do not need to install playwright or run npx playwright install separately. The MCP package handles everything required for browser automation.