Lighthouse MCP Server

通过 MCP 协议在 Claude 中直接运行 Lighthouse 网页性能审计,获取 Core Web Vitals、性能评分和优化建议。

功能

提供两个 MCP 工具:

audit_url — 单页审计

对一个 URL 运行 Lighthouse,返回:

• Core Web Vitals: LCP、CLS、INP
• 其他性能指标: FCP、TTFB、Speed Index、TBT
• 分类评分: Performance / Accessibility / SEO / Best Practices (0-100)
• 优化建议: 按预计可节省时间排序的改进机会

audit_batch — 批量审计

对多个 URL(最多 10 个)并行运行 Lighthouse,返回每个页面的核心指标,适合跨页面对比。

前置条件

• Node.js >= 18
• Google Chrome — Lighthouse 依赖 Chrome 运行,chrome-launcher 会自动查找。macOS 上安装 Chrome 即可。

安装

git clone <repo-url>/lighthouse-mcp.git
cd lighthouse-mcp
npm install
npm run build

在 Claude Code 中使用

在 ~/.claude/claude_desktop_config.json(或对应配置文件)中添加:

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

配置后重启 Claude Code,即可使用:

帮我审计一下 https://example.com 的性能
对比这三个页面的性能: https://a.com https://b.com https://c.com
用桌面模式审计 https://example.com

输出示例

{
  "url": "https://example.com",
  "device": "mobile",
  "scores": { "performance": 85 },
  "coreWebVitals": {
    "lcp_ms": 2500,
    "cls": 0.1,
    "inp_ms": 150
  },
  "otherMetrics": {
    "fcp_ms": 1800,
    "ttfb_ms": 200,
    "speedIndex_ms": 3000,
    "tbt_ms": 200
  },
  "opportunities": [
    { "title": "Reduce unused JavaScript", "potentialSavingsMs": 500 }
  ]
}

技术栈

• @modelcontextprotocol/sdk — MCP 协议实现
• lighthouse — Google Chrome 网页审计工具
• chrome-launcher — 无头 Chrome 启动
• TypeScript + ESM

License

MIT