lighthouse-mcp

🚀 灯塔 MCP 服务器

灯塔 MCP 服务器围绕 Google 的 Lighthouse 工具构建，可帮助测量网页的各项性能指标，为网页性能评估提供有力支持。

🚀 快速开始

灯塔 MCP 服务器能助力你对网页性能进行有效测量。配置好服务器后，你可以在 Claude 中使用它，例如询问 example.com 的性能分数是多少？，Claude 将使用 get_performance_score 工具来分析网站并返回结果。

✨ 主要特性

• 对任意 URL 运行全面的灯塔审核
• 获取性能分数和指标
• 配置设备仿真（手机/桌面）
• 控制网络节流
• 选择特定的审核类别

📦 安装指南

选项 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": ["/绝对路径/到/lighthouse-mcp/build/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

将 /绝对路径/到/lighthouse-mcp 替换为你项目的实际路径。

可用工具

run_audit

对一个 URL 运行全面的灯塔审核。

参数：

• 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"
}

🔧 技术细节

• 要求：
  • Node.js 16+
  • 浏览器：Chrome、Firefox 等现代浏览器

📄 许可证

灯塔 MCP 服务器授权链接