项目简介

Lighthouse MCP 是一个基于 Model Context Protocol (MCP) 构建的服务器端应用，专注于提供强大的Web性能分析能力。它通过标准化接口，使AI助手能够轻松调用Google Lighthouse进行数据收集，并执行多层次的性能分析（L1数据收集、L2深度分析、L3智能决策支持），从而快速识别性能瓶颈、管理性能预算并提供可操作的优化建议。

主要功能点

L1 数据收集： 远程执行 Google Lighthouse 对指定 URL 进行性能、可访问性、最佳实践和 SEO 等方面的审计，并存储原始报告。支持单页面和批量页面的数据收集，可强制刷新或利用缓存。
L2 深度分析： 对 Lighthouse 报告进行多维度分析，包括核心Web指标（Core Web Vitals）分数分解、关键请求链瓶颈识别、未使用的 CSS/JavaScript 代码检测、第三方脚本影响分析，以及全面的性能问题识别。
L3 智能决策支持： 提供高级智能分析，例如性能预算管理、跨网站性能模式洞察，以及基于历史数据和行业基准的趋势分析与战略性优化建议。
Prompt 模板支持： 能够根据分析结果生成结构化、易于理解的Prompt文本，优化AI助手与用户之间的交互。
会话与工具管理： 通过 MCP 协议声明和注册可用的工具集，允许 AI 客户端按需调用和执行。

安装步骤

Node.js 环境： 确保您的系统已安装 Node.js (推荐 v18 或更高版本)。

全局安装： 打开命令行终端，运行以下命令进行全局安装：

npm install -g lighthouse-mcp

项目内安装 (可选)： 如果您希望在自己的项目中作为依赖使用，可以运行：
```
npm install lighthouse-mcp
```

服务器配置 (MCP 客户端所需)

MCP 客户端需要以下 JSON 格式信息来连接和使用 Lighthouse MCP 服务器。这些信息定义了如何启动服务器以及其提供的能力。

{
  "serverName": "lighthouse-mcp",
  "description": "Lighthouse MCP 是一个高性能的Web应用性能分析服务器，提供数据收集、深度分析、问题检测和优化建议工具。",
  "command": "lhmcp",
  "args": ["--mcp"],
  "capabilities": {
    "tools": {
      "description": "Lighthouse MCP 提供了多层级的性能分析工具，包括数据收集、核心Web指标分析、关键请求链检测、未使用代码优化、第三方脚本影响评估、性能预算管理及跨站模式洞察等。客户端可通过调用MCP的ListTools RPC方法获取所有可用工具的详细列表和Schema。"
    }
  }
}

基本使用方法 (命令行工具)

Lighthouse MCP 也提供命令行界面，您可以在本地直接使用：

分析单个网站： 运行 Lighthouse 性能分析。

lhmcp https://example.com

指定设备类型和分析类别：

lhmcp https://example.com --device desktop -c performance,seo

包含关键链和未使用代码分析：

lhmcp https://example.com --chains --unused

输出原始 JSON 报告：

lhmcp https://example.com --json > report.json

关键词

项目简介

主要功能点

安装步骤

服务器配置 (MCP 客户端所需)

基本使用方法 (命令行工具)

信息