Lighthouse Mcp

by priyankark

154 stars

677 downloads

Not rated

GitHub Website

Developer Tools

About

Allows AI assistants such as Amp/Cline/Cursor/Claude Code/Codex/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!

Details

Author: priyankark
GitHub stars: 154
Downloads: 677
Categories: Developer Tools

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 Lighthouse Mcp

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "lighthouse mcp": {
            "lighthouse": {
                "command": "npx",
                "args": [
                    "lighthouse-mcp"
                ],
                "disabled": false,
                "autoApprove": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "lighthouse mcp": {
            "lighthouse": {
                "command": "npx",
                "args": [
                    "lighthouse-mcp"
                ],
                "disabled": false,
                "autoApprove": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "lighthouse mcp": {
            "lighthouse": {
                "command": "npx",
                "args": [
                    "lighthouse-mcp"
                ],
                "disabled": false,
                "autoApprove": []
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "lighthouse mcp": {
            "lighthouse": {
                "command": "npx",
                "args": [
                    "lighthouse-mcp"
                ],
                "disabled": false,
                "autoApprove": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "lighthouse mcp": {
            "lighthouse": {
                "command": "npx",
                "args": [
                    "lighthouse-mcp"
                ],
                "disabled": false,
                "autoApprove": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "lighthouse mcp": {
            "lighthouse": {
                "command": "npx",
                "args": [
                    "lighthouse-mcp"
                ],
                "disabled": false,
                "autoApprove": []
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "lighthouse mcp": {
            "lighthouse": {
                "command": "npx",
                "args": [
                    "lighthouse-mcp"
                ],
                "disabled": false,
                "autoApprove": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "lighthouse mcp": {
            "lighthouse": {
                "command": "npx",
                "args": [
                    "lighthouse-mcp"
                ],
                "disabled": false,
                "autoApprove": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "lighthouse mcp": {
            "lighthouse": {
                "command": "npx",
                "args": [
                    "lighthouse-mcp"
                ],
                "disabled": false,
                "autoApprove": []
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "lighthouse mcp": {
            "lighthouse": {
                "command": "npx",
                "args": [
                    "lighthouse-mcp"
                ],
                "disabled": false,
                "autoApprove": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "lighthouse mcp": {
            "lighthouse": {
                "command": "npx",
                "args": [
                    "lighthouse-mcp"
                ],
                "disabled": false,
                "autoApprove": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "lighthouse mcp": {
            "lighthouse": {
                "command": "npx",
                "args": [
                    "lighthouse-mcp"
                ],
                "disabled": false,
                "autoApprove": []
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "lighthouse mcp": {
            "lighthouse": {
                "command": "npx",
                "args": [
                    "lighthouse-mcp"
                ],
                "disabled": false,
                "autoApprove": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "lighthouse mcp": {
            "lighthouse": {
                "command": "npx",
                "args": [
                    "lighthouse-mcp"
                ],
                "disabled": false,
                "autoApprove": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "lighthouse mcp": {
            "lighthouse": {
                "command": "npx",
                "args": [
                    "lighthouse-mcp"
                ],
                "disabled": false,
                "autoApprove": []
            }
        }
    }
}

From the repository

Install via the MCP Registry, npx lighthouse-mcp, npm install -g lighthouse-mcp, or local clone and build. Then add a lighthouse entry to your MCP settings file with the appropriate command and args. Once configured, ask Claude or another MCP client to audit a URL.

`run_audit`

Run a Lighthouse audit on a URL

`get_performance_score`

Get just the performance score for a URL

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "lighthouse mcp": {
            "lighthouse": {
                "command": "npx",
                "args": [
                    "lighthouse-mcp"
                ],
                "disabled": false,
                "autoApprove": []
            }
        }
    }
}

McpServers

{
    "lighthouse": {
        "command": "npx",
        "args": [
            "lighthouse-mcp"
        ],
        "disabled": false,
        "autoApprove": []
    }
}

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

1. Clone this repository
2. Install dependencies:

   npm install

3. Build the project:

   npm run build

4. 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

</a>

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

run_audit

get_performance_score

Claude Desktop / Cursor

McpServers

Lighthouse MCP Server

Features

Installation

Option 1: From MCP Registry (Recommended)

Option 2: Using npx

Option 3: Global Installation

Option 4: Local Development

MCP Configuration

When installed via npm (global or npx)

When using local development version

Available Tools

run_audit

get_performance_score

Example Usage

Requirements

Endorsements

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Playwright

`run_audit`

`get_performance_score`