GitHub - priyankark/lighthouse-mcp: Allows AI assistants such as Amp/Cline/Cursor/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!

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:

Option 3: Global Installation

Install the package globally from npm:

npm install -g lighthouse-mcp

Then run it:

Option 4: Local Development

Clone this repository
Install dependencies:
Build the project:
Run the server:

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 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:

{
  "url": "https://example.com",
  "categories": ["performance", "accessibility"],
  "device": "desktop",
  "throttling": false
}

get_performance_score

Get just the performance score for a URL.