io.github.priyankark/lighthouse-mcp
MCP server for Google Lighthouse performance metrics
Open source Open in the app JSON README (API)
About
MCP server for Google Lighthouse performance metrics
Details
- Kind
- MCP servers
- Topic
- Cloud & DevOps
- Publisher
- priyankark
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.9
- Stars
- 203
- Forks
- 20
- Open pull requests
- 6
- Last push
- 2026-05-23T14:42:08Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 04:01:13
- Updated
- 2026-08-29 04:01:13
- Origin id
io.github.priyankark/lighthouse-mcp
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: From MCP Registry (Recommended)
This server is available in the [Model Context Protocol Registry](https://registry.modelcontextprotocol.io/servers/io.github.priyankark/lighthouse-mcp). Install it using your MCP client or Claude Desktop.
### Option 2: Using npx
You can run the tool directly using npx without installation:
```bash
npx lighthouse-mcp
```
### Option 3: Global Installation
Install the package globally from npm:
```bash
npm install -g lighthouse-mcp
```
Then run it:
```bash
lighthouse-mcp
```
### Option 4: 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
<a href="https://glama.ai/mcp/servers/@priyankark/lighthouse-mcp">
<img width="380" height="200" src="https://glama.ai/mcp/servers/@priyankark/lighthouse-mcp/badge" />
</a>