Playwright-Lighthouse
About
Combines Playwright's browser automation with Lighthouse's auditing capabilities to analyze website performance, generate detailed reports, and capture screenshots for web development optimization.
Details
- Repository
- kbyk004-diy/playwright-lighthouse-mcp
- License
- MIT
Explore
- Performance analysis with Lighthouse
- Screenshot capture
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Playwright-LighthouseCommand (node, npx, python, etc.)nodeArguments-
Argument 1
/path-to/playwright-lighthouse-mcp/build/index.js
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- Node.js 18 or higher
- npm
npm install
npx playwright install
Add the following to the Claude for Desktop configuration file (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"playwright-lighthouse": {
"command": "node",
"args": [
"/path-to/playwright-lighthouse-mcp/build/index.js"
]
}
}
}
run-lighthouse
Runs a Lighthouse performance analysis on the currently open page. Parameters: url (string), categories (array of strings, default: ['performance']), maxItems (number, default: 3, max: 5)
take-screenshot
Takes a screenshot of the currently open page. Parameters: url (string), fullPage (boolean, default: false)
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"playwright-lighthouse": {
"cwd": "string (optional)",
"env": {},
"args": [
"/path-to/playwright-lighthouse-mcp/build/index.js"
],
"shell": false,
"command": "node"
}
}
}Linux
{
"cwd": "string (optional)",
"env": [],
"args": [
"/path-to/playwright-lighthouse-mcp/build/index.js"
],
"shell": false,
"command": "node"
}Macos
{
"cwd": "string (optional)",
"env": [],
"args": [
"/path-to/playwright-lighthouse-mcp/build/index.js"
],
"shell": false,
"command": "node"
}Windows
{
"cwd": "string (optional)",
"env": [],
"args": [
"/path-to/playwright-lighthouse-mcp/build/index.js"
],
"shell": false,
"command": "node"
}A MCP server that analyzes web site performance using Playwright and Lighthouse. Through the Model Context Protocol (MCP), LLMs can perform web site performance analysis.
Features
- Performance analysis with Lighthouse
- Screenshot capture
Setup
Prerequisites
- Node.js 18 or higher
- npm
Installation
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
