lighthouse-mcp

Lighthouse MCP Server

An MCP server that wraps around Google's Lighthouse tool to help measure various performance metrics for web pages.

Lighthouse MCP Server Screenshot

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:

npx lighthouse-mcp

Option 2: Global Installation

Install the package globally:

npm install -g lighthouse-mcp

Then run it:

lighthouse-mcp

Option 3: 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 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.

Parameters:

url (required): The URL to audit
device (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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

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!

Related Resources

Reddit Discussion about this server

Related MCP Servers

PageSpeed MCP Server
PhialsBasement
-
security
A
license
-
quality
Acts as a bridge between AI models and Google's PageSpeed Insights API, enabling detailed performance analysis of websites.
Last updated -
4
4
JavaScript
MIT License
Mentor MCP Server
cyanheads
A
security
A
license
A
quality
Provides LLM Agents with AI-powered mentorship for code review, design critique, writing feedback, and brainstorming using the Deepseek API, enabling enhanced output in various development and strategic planning tasks.
Last updated -
5
15
TypeScript
Apache 2.0
MCP Server Pagespeed
enemyrr
A
security
A
license
A
quality
Enables AI models to analyze webpage performance using the Google PageSpeed Insights API, providing real-time performance scores and improvement suggestions.
Last updated -
1
7
1
JavaScript
MIT License
Lightdash MCP Server
syucream
A
security
A
license
A
quality
MCP-compatible server that enables AI assistants to interact with Lightdash analytics data, providing tools to list and retrieve projects, spaces, charts, dashboards, and metrics through a standardized interface.
Last updated -
13
17
17
TypeScript
MIT License

View all related MCP servers