Lighthouse Mcp

开发官方认证远程 TypeScript

🚀 灯塔 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：本地开发

克隆此仓库
安装依赖：
```
npm install
```
构建项目：
```
npm run build
```
运行服务器：
```
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 的性能分数。