lighthouse-mcp

by priyankark
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Integrates with Google's Lighthouse tool to provide web performance analysis and auditing capabilities.

  • Wraps around Google's Lighthouse tool to run comprehensive performance audits on web pages, providing performance scores, metrics, device emulation, network throttling control, and specific audit categories (performance, accessibility, best-practices, seo, pwa).

  • Enables auditing of Progressive Web App (PWA) metrics as one of the available audit categories when running Lighthouse tests.

Lighthouse MCP サーバー

Google の Lighthouse ツールをラップして、Web ページのさまざまなパフォーマンス メトリックを測定するのに役立つ MCP サーバー。

特徴

  • あらゆる URL に対して包括的な Lighthouse 監査を実行します
  • パフォーマンススコアと指標を取得する
  • デバイスエミュレーション(モバイル/デスクトップ)を構成する
  • ネットワークスロットリングを制御する
  • 特定の監査カテゴリを選択する

インストール

オプション1: npxを使用する(推奨)

インストールせずに npx を使用してツールを直接実行できます。

npx lighthouse-mcp

オプション2: グローバルインストール

パッケージをグローバルにインストールします。

npm install -g lighthouse-mcp

次にそれを実行します:

lighthouse-mcp

オプション3:地域開発

  1. このリポジトリをクローンする
  2. 依存関係をインストールします:
    npm install
  3. プロジェクトをビルドします。
    npm run build
  4. サーバーを実行します。
    npm start

MCP構成

npm(グローバルまたはnpx)経由でインストールした場合

MCP 設定構成ファイルに次の内容を追加します。

{ "mcpServers": { "lighthouse": { "command": "npx", "args": ["lighthouse-mcp"], "disabled": false, "autoApprove": [] } } }

ローカル開発版を使用する場合

MCP 設定構成ファイルに次の内容を追加します。

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

/absolute/path/to/lighthouse-mcpこのプロジェクトへの実際のパスに置き換えます。

利用可能なツール

監査の実行

URL に対して包括的な Lighthouse 監査を実行します。

パラメータ:

  • url (必須): 監査するURL
  • categories (オプション):監査するカテゴリの配列(デフォルトはすべて)
    • オプション: 「パフォーマンス」、「アクセシビリティ」、「ベストプラクティス」、「SEO」、「PWA」
  • device (オプション):エミュレートするデバイス(デフォルトは「モバイル」)
    • オプション:「モバイル」、「デスクトップ」
  • throttling (オプション):ネットワークスロットリングを適用するかどうか(デフォルトはtrue)

例:

{ "url": "https://example.com", "categories": ["performance", "accessibility"], "device": "desktop", "throttling": false }

パフォーマンススコアを取得する

URL のパフォーマンス スコアのみを取得します。

パラメータ:

  • url (必須): 監査するURL
  • device (オプション):エミュレートするデバイス(デフォルトは「モバイル」)
    • オプション:「モバイル」、「デスクトップ」

例:

{ "url": "https://example.com", "device": "mobile" }

使用例

MCP サーバーが設定されると、Claude で使用できるようになります。

What's the performance score for example.com?

Claude はget_performance_scoreツールを使用して Web サイトを分析し、結果を返します。

要件

  • Node.js 16以上
  • Chrome/Chromium ブラウザ (Lighthouse 用)

推薦

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Cursor/Cline/GitHub CopilotなどのAIアシスタントがGoogleのLighthouseツールを使用してウェブページのパフォーマンス指標を測定できるようにします。その後、エージェントループを実行して、アシスタントにこれらの指標を最適化させることができます。

  1. Features
    1. Installation
      1. Option 1: Using npx (Recommended)
      2. Option 2: Global Installation
      3. Option 3: Local Development
    2. MCP Configuration
      1. When installed via npm (global or npx)
      2. When using local development version
    3. Available Tools
      1. run_audit
      2. get_performance_score
    4. Example Usage
      1. Requirements
        1. Endorsements
          ID: xip1afyf7n