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
- Author
- kbyk004
- Repository
- kbyk004-diy/playwright-lighthouse-mcp
- GitHub stars
- 1
- License
- MIT License
- Categories
- Productivity, Developer Tools, Design, AI, Media, Infrastructure, Frontend
- Tags
- #web
Jump to
- 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
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"
}Playwright-Lighthouse MCP Server
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.
