Playwright-Lighthouse MCP サーバー

PlaywrightとLighthouseを用いてウェブサイトのパフォーマンスを分析するMCPサーバー。モデルコンテキストプロトコル（MCP）を通じて、LLMはウェブサイトのパフォーマンス分析を実行できます。

特徴

Lighthouseによるパフォーマンス分析
スクリーンショットキャプチャ

設定

前提条件

Node.js 18以上
npm

インストール

# Clone the repository
git clone https://github.com/kbyk004/playwright-lighthouse-mcp.git
cd playwright-lighthouse-mcp

# Install dependencies
npm install
npx playwright install

# Build
npm run build

使用法

MCPサーバーのデバッグ

npm run inspector

MCPクライアントとの統合

このサーバーは、モデルコンテキストプロトコル（MCP）をサポートするクライアントで使用するように設計されています。例えば、Claude for Desktopと統合できます。

Claude for Desktop の設定例

Claude for Desktop 構成ファイル ( ~/Library/Application Support/Claude/claude_desktop_config.json ) に以下を追加します。

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

利用可能なツール

1. ランライトハウス

現在開いているページで Lighthouse パフォーマンス分析を実行します。

パラメータ:

url : 分析したいウェブサイトのURL
categories : 分析するカテゴリの配列 (デフォルト: ["performance"])
- 利用可能なカテゴリ: 「パフォーマンス」、「アクセシビリティ」、「ベストプラクティス」、「SEO」、「PWA」
maxItems : 各カテゴリに表示する改善項目の最大数（デフォルト: 3、最大: 5）

2. スクリーンショットを撮る

現在開いているページのスクリーンショットを撮ります。

パラメータ:

url : キャプチャしたいウェブサイトのURL
fullPage : trueの場合、ページ全体のスクリーンショットをキャプチャします（デフォルト: false）

出力形式

分析結果は次のとおりです。

選択した各カテゴリーの総合スコアとカラーインジケーター
カテゴリー別にまとめた主要な改善領域
保存されたレポートファイルへのパス

ライセンス

MITライセンス - 詳細はライセンスを参照

Playwright-Lighthouse MCP Server

Integrations