Playwright MCP Server
English | 日本語
This project is a server that provides Playwright web page content retrieval functionality using the Model Context Protocol (MCP).
Features
- Page navigation
- Full page content retrieval
- Visible content retrieval
- Interactive elements detection
- Mouse operation simulation
- Echo functionality for testing
Installation
Installing via Smithery
To install Playwright MCP Server for Claude Desktop automatically via Smithery:
Manual Installation
Usage
Starting the Server
MCP Tools
The following tools are available:
navigate
- Navigate to a specified URL
- Arguments:
{ url: string }
- Returns: Navigation result
get_all_content
- Retrieve content from the entire page
- Arguments: None
- Returns: All text content from the page
get_visible_content
- Retrieve currently visible content
- Arguments:
{ minVisiblePercentage?: number }
- Returns: Visible text content
get_interactive_elements
- Get position information of interactive elements (buttons, links, etc.) on the page
- Arguments: None
- Returns: Coordinates and boundary information of interactive elements
move_mouse
- Move mouse cursor to specified coordinates
- Arguments:
{ x: number, y: number }
- Returns: Operation result
mouse_click
- Execute mouse click at specified coordinates
- Arguments:
{ x: number, y: number, button?: "left" | "right" | "middle", clickCount?: number }
- Returns: Click operation result
mouse_wheel
- Execute mouse wheel scrolling
- Arguments:
{ deltaY: number, deltaX?: number }
- Returns: Scroll operation result
drag_and_drop
- Execute drag and drop operation
- Arguments:
{ sourceX: number, sourceY: number, targetX: number, targetY: number }
- Returns: Drag and drop operation result
echo
- Echo tool for testing
- Arguments:
{ message: string }
- Returns: Sent message
Development
Running Tests
Test Structure
tools/*.test.ts
: Function tests for each toolmcp-server.test.ts
: MCP server function tests
Implementation Features
- Content Retrieval
- Full page content retrieval
- Visible content only retrieval
- Proper HTML parsing
- Interaction
- Detection and position information retrieval of interactive elements
- Mouse operation simulation (movement, clicks, scrolling)
- Drag and drop support
- Error Handling
- Proper navigation error handling
- Timeout processing
- Invalid URL detection
- Configuration Flexibility
- Headless/head mode selection
- Custom user agent
- Viewport size settings
Important Notes
- Ensure necessary environment variables are set before using the MCP server
- Follow the terms of service of target websites when retrieving web page content
- Maintain appropriate intervals when sending multiple requests
- When performing mouse operations, maintain appropriate intervals as they simulate actual user interactions
License
ISC
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
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.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that provides browser automation capabilities using Playwright. This server enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment.Last updated -139,4573,642TypeScriptMIT License
- AsecurityFlicenseAqualityA server that enables browser automation using Playwright, allowing interaction with web pages, capturing screenshots, and executing JavaScript in a browser environment through LLMs.Last updated -129,4571TypeScript
- -securityAlicense-qualityA Model Context Protocol server that provides browser automation capabilities using Playwright, enabling LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment.Last updated -3PythonApache 2.0
- -securityAlicense-qualityA browser automation server providing Playwright capabilities for controlling web browsers, capturing screenshots, extracting content, and performing complex interactions through an MCP interface.Last updated -PythonApache 2.0