LightScout MCP

LightScout MCP

属于 TestScout MCP Suite — 面向现代开发团队的 AI 驱动 QA 工具。

由 Lighthouse 提供支持的 Core Web Vitals 分析。可作为 MCP 服务供 AI 编码工具（Claude Code、Cursor、Windsurf 等）使用，也可作为独立 CLI 用于 CI 流水线和终端。提供四种工具：分析 URL、比较两个 URL、检查是否符合阈值，或爬取整个网站。

要求

• Node.js >= 18
• Google Chrome 或 Chromium

MCP 服务设置

Claude Code

claude mcp add lightscout -- npx -y lightscout-mcp

Cursor、VS Code、Windsurf、Cline、Roo Code、Gemini CLI

这些客户端均使用相同的 mcpServers JSON 格式。将以下内容添加到相应的配置文件中：

{
  "mcpServers": {
    "lightscout": {
      "command": "npx",
      "args": ["-y", "lightscout-mcp"]
    }
  }
}

客户端	配置文件
Cursor	~/.cursor/mcp.json
VS Code (Copilot)	.vscode/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json
Cline	Settings > MCP > Edit Config
Roo Code	.roo/mcp.json
Gemini CLI	~/.gemini/settings.json

Zed

Zed 使用 context_servers，而不是 mcpServers：

{
  "context_servers": {
    "lightscout": {
      "command": "npx",
      "args": ["-y", "lightscout-mcp"]
    }
  }
}

CLI

安装

npm install -g lightscout-mcp

无需安装即可试用

npx -p lightscout-mcp lightscout analyze https://example.com

命令

lightscout analyze <url> [--device mobile|desktop] [--categories perf,a11y,seo,best-practices]
lightscout compare <urlA> [urlB] [--device mobile|desktop]
lightscout crawl <url> [--max-pages N] [--device mobile|desktop]
lightscout check <url> [--perf 90] [--lcp 2500] [--fcp 3000] [--cls 0.1] [--tbt 300] [--ttfb 1800]

示例

分析单个页面：

lightscout analyze https://example.com
lightscout analyze https://example.com --device desktop --categories performance,accessibility

比较两个 URL，或比较同一 URL 在移动设备与桌面设备上的表现：

lightscout compare https://a.com https://b.com
lightscout compare https://example.com                    # mobile vs desktop

爬取网站并审计发现的页面：

lightscout crawl https://example.com --max-pages 5

CI 质量门禁（失败时退出码为 1）：

lightscout check https://example.com --perf 90 --lcp 2500

工具

analyze_performance

对 URL 运行 Lighthouse。返回性能得分、Core Web Vitals（LCP、FCP、CLS、TBT、SI、TTFB）及其良好／需改进／较差评级、按影响排序的主要建议和诊断结果。

参数	类型	必填	描述
url	string	是	要分析的 URL
device	"mobile" | "desktop"	否	设备模拟（默认：mobile）
categories	string[]	否	Lighthouse 类别（默认：["performance"]）

compare_performance

比较两个 URL 之间的 Core Web Vitals，或比较同一 URL 在移动设备与桌面设备上的表现。显示各项指标的差值，并标明胜出方。

参数	类型	必填	描述
urlA	string	是	第一个 URL
urlB	string	否	第二个 URL。若省略，则比较 urlA 在移动设备与桌面设备上的表现
device	"mobile" | "desktop"	否	比较两个 URL 时使用的设备模拟（默认：mobile）

check_threshold

根据性能阈值进行通过/失败检查。适用于 CI 质量门禁。

参数	类型	必填	描述
url	string	是	要检查的 URL
device	"mobile" | "desktop"	否	设备模拟（默认：mobile）
thresholds	object	否	自定义阈值（见下方默认值）

默认阈值采用 Google 的“差”边界——只有指标确实很差时才会判定失败：

指标	默认值（超过则失败）
performance	< 50
LCP	> 4000ms
FCP	> 3000ms
CLS	> 0.25
TBT	> 600ms
TTFB	> 1800ms

crawl_site

发现网站上的页面（通过 sitemap.xml 或链接抓取），并对每个页面运行 Lighthouse。返回各页面的结果，以及包含平均值/最小值/最大值评分和常见问题的网站级摘要。

参数	类型	必填	描述
url	string	是	要抓取的网站 URL 或主页
device	"mobile" | "desktop"	否	设备模拟（默认：mobile）
maxPages	number	否	要分析的最大页面数（默认：20，最大：20）

首先通过 sitemap.xml 发现页面；如果失败，则回退到链接抓取。最多并行运行 3 次 Lighthouse 测试。

CWV 评级阈值

指标	良好	需要改进	差
LCP	<= 2500ms	2500-4000ms	> 4000ms
FCP	<= 1800ms	1800-3000ms	> 3000ms
CLS	<= 0.1	0.1-0.25	> 0.25
TBT	<= 200ms	200-600ms	> 600ms
SI	<= 3400ms	3400-5800ms	> 5800ms
TTFB	<= 800ms	800-1800ms	> 1800ms

说明

• 使用 TBT（总阻塞时间）代替 INP/FID，因为 Lighthouse 仅运行实验室测试，不涉及真实用户交互。
• 最多并发运行 3 次 Lighthouse 测试（通过信号量控制）。
• Chrome 以无头模式启动，并在每次审计后终止。
• MCP 响应经过令牌优化，采用精简指标和紧凑 JSON。

TestScout MCP Suite

LightScout 是 TestScout MCP Suite 中的首款工具。更多工具即将推出：

工具	描述	状态
lightscout-mcp	Core Web Vitals 和 Lighthouse 分析	可用
testscout-diagnose	错误分诊和根因分析	即将推出
testscout-scrape	用于测试的结构化数据提取	即将推出
testscout-plan	AI 测试计划和代码生成	即将推出
testscout-load	负载测试生成和分析	即将推出
testscout-maintain	自愈式测试维护	即将推出

在 testscout.dev 关注开发进展。

许可证

MIT