https://github.com/priyankark/lighthouse-mcp
Allows AI assistants such as Cursor/Cline/GitHub Copilot to use Google's lighthouse tool to measure perf metrics for your webpage. You can then run an agentic loop and get the assistants to optimize those metrics!
https://github.com/priyankark/lighthouse-mcp
audit-webpage-ai lighthouse lighthouse-ai lighthouse-mcp
Last synced: about 1 month ago
JSON representation
Allows AI assistants such as Cursor/Cline/GitHub Copilot to use Google's lighthouse tool to measure perf metrics for your webpage. You can then run an agentic loop and get the assistants to optimize those metrics!
- Host: GitHub
- URL: https://github.com/priyankark/lighthouse-mcp
- Owner: priyankark
- License: mit
- Created: 2025-04-07T18:44:34.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-04-17T16:49:27.000Z (2 months ago)
- Last Synced: 2025-04-18T07:06:14.214Z (2 months ago)
- Topics: audit-webpage-ai, lighthouse, lighthouse-ai, lighthouse-mcp
- Language: JavaScript
- Homepage:
- Size: 288 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- mcp-index - Lighthouse MCP Server - Run comprehensive audits on web pages to measure performance metrics, simulate different device environments, and apply network conditions. Provides detailed insights and scores to help optimize website performance. (Data Analytics)
README
# 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: Using npx (Recommended)
You can run the tool directly using npx without installation:
```bash
npx lighthouse-mcp
```
### Option 2: Global Installation
Install the package globally:
```bash
npm install -g lighthouse-mcp
```
Then run it:
```bash
lighthouse-mcp
```
### Option 3: Local Development
1. Clone this repository
2. Install dependencies:
```bash
npm install
```
3. Build the project:
```bash
npm run build
```
4. Run the server:
```bash
npm start
```
## MCP Configuration
### When installed via npm (global or npx)
Add the following to your MCP settings configuration file:
```json
{
"mcpServers": {
"lighthouse": {
"command": "npx",
"args": ["lighthouse-mcp"],
"disabled": false,
"autoApprove": []
}
}
}
```
### When using local development version
Add the following to your MCP settings configuration file:
```json
{
"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 audit
- `categories` (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:**
```json
{
"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 audit
- `device` (optional): Device to emulate (defaults to "mobile")
- Options: "mobile", "desktop"
**Example:**
```json
{
"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
