百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
L

lighthouse-mcp

> 编程语言
开源

允许 AI 助手(如 Amp/Cline/Cursor/Claude Code/Codex/GitHub Copilot)使用 Google 的 lighthouse 工具来测量网页的性能指标。您可以

199 stars0 点赞2 次浏览
访问官网GitHub

工具介绍

允许 AI 助手(如 Amp/Cline/Cursor/Claude Code/Codex/GitHub Copilot)使用 Google 的 lighthouse 工具来测量网页的性能指标。您可以

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:

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"
  • 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 22.19+
  • Chrome/Chromium browser (for Lighthouse)

Endorsements

Security

Chrome runs with its sandbox enabled. Localhost, IPv4 loopback, and IPv6 loopback remain supported by default. Private, link-local, cloud metadata, and other non-public destinations are blocked, including requests made by redirects and page resources. Connections use validated IP addresses to prevent DNS rebinding. Because loopback access is intentional, audit only pages you trust to access services on your own machine. For hostile sites, use a separate environment with network isolation.

Audits are limited to one at a time and time out after 120 seconds. Chrome and the audit proxy are cleaned up after success or failure.

Public-only audits

Set AUDIT_ALLOW_LOOPBACK=false to reject loopback destinations as well as private and metadata addresses. Hosted workers must use this setting and infrastructure egress isolation. Local development keeps loopback access by default.

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

JavaScriptaudit-webpage-ailighthouselighthouse-ailighthouse-mcp

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月18日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言