# 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 即可。

## 安装

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

## 在 Claude Code 中使用

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

```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
```

## 输出示例

```json
{
  "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