Lighthouse MCP 服务器

一个封装 Google Lighthouse 工具的 MCP 服务器，用于帮助衡量网页的各种性能指标。

功能特性

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

安装

选项 1：使用 npx (推荐)

您可以使用 npx 直接运行该工具，无需安装：

npx lighthouse-mcp

选项 2：全局安装

全局安装该软件包：

npm install -g lighthouse-mcp

然后运行它：

lighthouse-mcp

选项 3：本地开发

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", "pwa"
• 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 一起使用：

example.com 的性能评分是多少？

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

要求

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