priyankark/lighthouse-mcp
If you are the rightful owner of lighthouse-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
An MCP server that wraps around Google's Lighthouse tool to help measure various performance metrics for web pages.
Lighthouse MCP Server
An MCP server that wraps around Google's Lighthouse tool to help measure various performance metrics for web pages.
Features
- Run comprehensive Lighthouse audits on any URL
- Get performance scores and metrics
- Configure device emulation (mobile/desktop)
- Control network throttling
- Select specific audit categories
Installation
Option 1: From MCP Registry (Recommended)
This server is available in the Model Context Protocol Registry. Install it using your MCP client or Claude Desktop.
Option 2: Using npx
You can run the tool directly using npx without installation:
npx lighthouse-mcp
Option 3: Global Installation
Install the package globally from npm:
npm install -g lighthouse-mcp
Then run it:
lighthouse-mcp
Option 4: Local Development
- Clone this repository
- Install dependencies:
npm install - Build the project:
npm run build - Run the server:
npm start
MCP Configuration
When installed via npm (global or npx)
Add the following to your MCP settings configuration file:
{
"mcpServers": {
"lighthouse": {
"command": "npx",
"args": ["lighthouse-mcp"],
"disabled": false,
"autoApprove": []
}
}
}
When using local development version
Add the following to your MCP settings configuration file:
{
"mcpServers": {
"lighthouse": {
"command": "node",
"args": ["/absolute/path/to/lighthouse-mcp/build/index.js"],
"disabled": false,
"autoApprove": []
}
}
}
Replace /absolute/path/to/lighthouse-mcp with the actual path to this project.
Available Tools
run_audit
Run a comprehensive Lighthouse audit on a URL.
Parameters:
url(required): The URL to auditcategories(optional): Array of categories to audit (defaults to all)- Options: "performance", "accessibility", "best-practices", "seo", "pwa"
device(optional): Device to emulate (defaults to "mobile")- Options: "mobile", "desktop"
throttling(optional): Whether to apply network throttling (defaults to true)
Example:
{
"url": "https://example.com",
"categories": ["performance", "accessibility"],
"device": "desktop",
"throttling": false
}
get_performance_score
Get just the performance score for a URL.
Parameters:
url(required): The URL to auditdevice(optional): Device to emulate (defaults to "mobile")- Options: "mobile", "desktop"
Example:
{
"url": "https://example.com",
"device": "mobile"
}
Example Usage
Once the MCP server is configured, you can use it with Claude:
What's the performance score for example.com?
Claude will use the get_performance_score tool to analyze the website and return the results.
Requirements
- Node.js 16+
- Chrome/Chromium browser (for Lighthouse)
Endorsements
