Lighthouse Mcp

Lighthouse MCP 服务

一个封装 Google Lighthouse 工具的 MCP 服务，可帮助测量网页的各项性能指标。

功能

• 对任意 URL 执行全面的 Lighthouse 审计
• 获取性能评分和指标
• 配置设备模拟（移动设备/桌面设备）
• 控制网络限速
• 选择特定的审计类别

安装

选项 1：通过 MCP Registry 安装（推荐）

此服务已发布在 Model Context Protocol Registry 中。使用 MCP 客户端或 Claude Desktop 安装。

选项 2：使用 npx

无需安装，即可直接使用 npx 运行此工具：

npx lighthouse-mcp

选项 3：全局安装

从 npm 全局安装此软件包：

npm install -g lighthouse-mcp

然后运行：

lighthouse-mcp

选项 4：本地开发

1. 克隆此仓库
2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

4. 运行服务：

   npm start
   

MCP 配置

通过 npm 安装时（全局安装或 npx）

将以下内容添加到 MCP 设置配置文件中：

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

使用本地开发版本时

将以下内容添加到 MCP 设置配置文件中：

{
  "mcpServers": {
    "lighthouse": {
      "command": "node",
      "args": ["/absolute/path/to/lighthouse-mcp/build/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

将 /absolute/path/to/lighthouse-mcp 替换为此项目的实际路径。

可用工具

run_audit

对 URL 执行全面的 Lighthouse 审计。

参数：

• url（必填）：要审计的 URL
• categories（可选）：要审计的类别数组（默认为全部类别）
  • 选项："performance"、"accessibility"、"best-practices"、"seo"
• device（可选）：要模拟的设备（默认为 "mobile"）
  • 选项："mobile"、"desktop"
• throttling（可选）：是否应用网络限速（默认为 true）

示例：

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

get_performance_score

仅获取 URL 的性能评分。

参数：

• url（必填）：要审计的 URL
• device（可选）：要模拟的设备（默认为 "mobile"）
  • 选项："mobile"、"desktop"

示例：

{
  "url": "https://example.com",
  "device": "mobile"
}

使用示例

配置好 MCP 服务后，即可通过 Claude 使用：

What's the performance score for example.com?

Claude 将使用 get_performance_score 工具分析网站并返回结果。

要求

• Node.js 22.19+
• Chrome/Chromium 浏览器（用于 Lighthouse）

背书

安全

Chrome 在启用沙箱的情况下运行。默认仍支持 localhost、IPv4 回环地址和 IPv6 回环地址。私有地址、链路本地地址、云元数据地址及其他非公开目标均会被阻止，包括重定向和页面资源发起的请求。连接使用经过验证的 IP 地址，以防止 DNS 重绑定。由于有意允许访问回环地址，请仅审计你信任其访问本机服务的页面。对于恶意网站，请使用启用了网络隔离的独立环境。

每次仅允许执行一项审计，超时时间为 120 秒。无论成功还是失败，都会清理 Chrome 和审计代理。

仅允许审计公开地址

设置 AUDIT_ALLOW_LOOPBACK=false，即可拒绝回环地址以及私有地址和元数据地址。托管工作进程必须使用此设置并启用基础设施出口隔离。本地开发默认允许访问回环地址。

维护者 CI 与发布

GitHub Actions 会在最低支持的 Node 版本和 Node 24 上运行构建、网络与发布策略测试、npm 安全审计以及真实 Chrome 冒烟测试。Node 24 还会在一个干净的临时项目中安装 npm tarball，并检查其可执行文件、依赖项、MCP 版本和浏览器审计。

每次推送到 main 都会运行发布流水线。软件包文件发生更改时，流水线会自动递增补丁版本（或遵循已提交的更高版本）、同步软件包元数据、重复验证、提交并标记发布、通过 provenance 发布到 npm，并创建 GitHub 发布。仅涉及文档、测试或工作流的更改不会发布新版本。运行时服务版本来自 package.json。

Dependabot 每周检查 npm 和 GitHub Actions。PR CI 运行成功后，只有在所有现有变更依赖项均为稳定版补丁/次要版本升级，且只有 package.json / package-lock.json 发生更改时，才会自动合并 npm 更新。主要版本升级、0.x 次要版本升级、降级、预发布版本和 GitHub Actions 更改都需要审核。合并作业只会运行来自 main 的可信代码，验证已测试的 PR 提交，并在机器人合并后显式触发发布。

npm 发布使用 npm GitHub 环境和 npm 可信发布者，配置为 priyankark/lighthouse-mcp、工作流 publish.yml、环境 npm，并允许直接发布。GitHub 中不会存储 npm 令牌。该环境只接受来自 main 的部署。

要重试失败的发布，请重新运行 Publish 工作流，或运行 ./release.sh。流水线会复用尚未发布的版本，并跳过已发布且未更改的软件包。如果保留的发布标签指向不同代码，流水线会停止，而不会覆盖该版本。对于破坏性更改，请在合并前于经过审核的 PR 中将 package.json 和 package-lock.json 更新为预期的主要/次要版本。