Playwright MCP Server

What is Playwright MCP Server?

Playwright MCP Server is a server that provides Playwright web page content retrieval and interaction functionality using the Model Context Protocol (MCP). It allows AI assistants to navigate pages, retrieve content, detect interactive elements, and simulate mouse operations.

How to use Playwright MCP Server?

Install via Smithery with npx -y @smithery/cli install @showfive/playwright-mcp-server --client claude or manually by running npm install and then npm run build followed by npm start. The server exposes MCP tools such as navigate, get_all_content, get_visible_content, get_interactive_elements, move_mouse, mouse_click, mouse_wheel, drag_and_drop, and echo.

Key features of Playwright MCP Server

• Page navigation to specified URLs
• Full or visible page content retrieval
• Interactive elements detection with position information
• Mouse operation simulation (movement, clicks, scrolling)
• Drag and drop support
• Echo functionality for testing

Use cases of Playwright MCP Server

• Automating web page content extraction for AI analysis
• Performing UI tests by simulating mouse interactions
• Retrieving visible content from dynamic web pages
• Testing MCP client-server communication with the echo tool
• Scraping full page text for downstream processing

FAQ from Playwright MCP Server

What tools does Playwright MCP Server provide?

It provides nine MCP tools: navigate, get_all_content, get_visible_content, get_interactive_elements, move_mouse, mouse_click, mouse_wheel, drag_and_drop, and echo.

How can I install Playwright MCP Server?

Install automatically via Smithery using npx -y @smithery/cli install @showfive/playwright-mcp-server --client claude, or manually by cloning the repo, running npm install, then npm run build and npm start.

What are the runtime requirements?

The README does not specify Node.js version or other system dependencies beyond requiring npm. Ensure necessary environment variables are set before using the server.

Does Playwright MCP Server support headless mode?

Yes, it offers configuration flexibility including headless/head mode selection, custom user agent, and viewport size settings.

Are there any usage restrictions?

Maintain appropriate intervals between requests and mouse operations to simulate real user interactions. Always follow the terms of service of target websites.