Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Automata-Labs-team/MCP-Server-Playwright
MCP server for browser automation using Playwright
https://github.com/Automata-Labs-team/MCP-Server-Playwright
Last synced: 10 days ago
JSON representation
MCP server for browser automation using Playwright
- Host: GitHub
- URL: https://github.com/Automata-Labs-team/MCP-Server-Playwright
- Owner: Automata-Labs-team
- License: mit
- Created: 2024-12-02T08:15:20.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2024-12-21T10:57:13.000Z (14 days ago)
- Last Synced: 2024-12-21T11:30:16.424Z (14 days ago)
- Language: JavaScript
- Size: 49.8 KB
- Stars: 16
- Watchers: 1
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - @automatalabs/mcp-server-playwright - Playwrightを使用したブラウザ自動化のためのMCPサーバー (サーバー実装 / 📂 <a name="browser-automation"></a>ブラウザ自動化)
README
MCP Server Playwright
A Model Context Protocol server that provides browser automation capabilities using Playwright
Enable LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment
## Table of Contents
- [Features](#features)
- [Installation](#installation)
- [Configuration](#configuration)
- [Components](#components)
- [Tools](#tools)
- [Resources](#resources)
- [License](#license)
## 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](https://smithery.ai/protocol/@automatalabs/mcp-server-playwright):
```bash
npx @smithery/cli install @automatalabs/mcp-server-playwright --client claude
```
You can install the package using either npx or mcp-get:
Using npx:
```bash
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:
```bash
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:
```json
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["-y", "@automatalabs/mcp-server-playwright"]
}
}
}
```
## Components
### Tools
#### `playwright_navigate`
Navigate to any URL in the browser
```javascript
{
"url": "https://stealthbrowser.cloud"
}
```
#### `playwright_screenshot`
Capture screenshots of the entire page or specific elements
```javascript
{
"name": "screenshot-name", // required
"selector": "#element-id", // optional
"fullPage": true // optional, default: false
}
```
#### `playwright_click`
Click elements on the page using CSS selector
```javascript
{
"selector": "#button-id"
}
```
#### `playwright_click_text`
Click elements on the page by their text content
```javascript
{
"text": "Click me"
}
```
#### `playwright_hover`
Hover over elements on the page using CSS selector
```javascript
{
"selector": "#menu-item"
}
```
#### `playwright_hover_text`
Hover over elements on the page by their text content
```javascript
{
"text": "Hover me"
}
```
#### `playwright_fill`
Fill out input fields
```javascript
{
"selector": "#input-field",
"value": "Hello World"
}
```
#### `playwright_select`
Select an option in a SELECT element using CSS selector
```javascript
{
"selector": "#dropdown",
"value": "option-value"
}
```
#### `playwright_select_text`
Select an option in a SELECT element by its text content
```javascript
{
"text": "Choose me",
"value": "option-value"
}
```
#### `playwright_evaluate`
Execute JavaScript in the browser console
```javascript
{
"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://`)
- 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](https://github.com/Automata-Labs-team/MCP-Server-Playwright/blob/main/LICENSE) file for details.