LightScout MCP

LightScout MCP

TestScout MCP Suite の一部 — 現代の開発チーム向けの AI 搭載 QA ツールです。

Lighthouse を活用した Core Web Vitals 分析ツールです。AI コーディングツール（Claude Code、Cursor、Windsurf など）向けの MCP サーバー、または CI パイプラインやターミナル向けのスタンドアロン CLI として実行できます。ツールは 4 種類です。URL の分析、2 つの 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 では mcpServers の代わりに context_servers を使用します。

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

2 つの 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

2 つの URL、または同じ URL のモバイル版とデスクトップ版で Core Web Vitals を比較します。指標ごとの差分と勝者を示します。

パラメーター	型	必須	説明
urlA	string	はい	1 つ目の URL
urlB	string	いいえ	2 つ目の URL。省略した場合、urlA のモバイル版とデスクトップ版を比較します
device	"mobile" | "desktop"	いいえ	2 つの URL を比較する際のデバイスのエミュレーション（デフォルト：mobile）

check_threshold

パフォーマンスのしきい値に対する合否チェックです。CI の品質ゲートに便利です。

パラメーター	型	必須	説明
url	string	はい	チェックする URL
device	"mobile" | "desktop"	いいえ	デバイスのエミュレーション（デフォルト：mobile）
thresholds	object	いいえ	カスタムしきい値（以下のデフォルトを参照）

デフォルトのしきい値には、Google の「poor（低評価）」の境界値を使用します。つまり、メトリクスが明らかに悪い場合にのみ失敗します。

メトリクス	デフォルト（これを超えると失敗）
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

注意事項

• Lighthouse は実際のユーザー操作を伴わないラボテストのみを実行するため、INP/FID ではなく TBT（合計ブロック時間）を使用します。
• Lighthouse は最大 3 件まで同時に実行されます（セマフォで制御）。
• 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