구글의 Lighthouse 도구를 감싸 웹페이지의 다양한 성능 지표를 측정하는 MCP 서버입니다.

특징

• 모든 URL에 대해 포괄적인 등대 감사 수행
• 성과 점수 및 지표 획득
• 장치 에뮬레이션 구성 (모바일/데스크톱)
• 제어 네트워크 제한
• 특정 감사 범주 선택

설치

옵션 1: MCP 등록부에서 (권장)

이 서버는 모델 컨텍스트 프로토콜 레지스트리에서 이용할 수 있습니다. MCP 클라이언트나 Claude 데스크톱을 사용해 설치하세요.

옵션 2: NPX 사용

설치 없이 npx로 직접 툴을 실행할 수 있습니다:

옵션 3: 글로벌 설치

npm에서 패키지를 전역적으로 설치하세요:

그다음 실행하세요:

옵션 4: 지역 개발

1. 이 저장소를 복제합니다

2. 의존성 설치:

3. 프로젝트 구축:

4. 서버 운영:

MCP 구성

npm(글로벌 또는 NPX)을 통해 설치할 때요

MCP 설정 파일에 다음 사항을 추가하세요:

로컬 개발 버전을 사용할 때

MCP 설정 파일에 다음 사항을 추가하세요:

/absolute/path/to/lighthouse-mcp를 이 프로젝트로 가는 실제 경로로 바꿔주세요.

사용 가능한 도구

run_audit

Lighthouse MCP Server

An MCP server that wraps around Google’s Lighthouse tool to help measure various performance metrics for web pages.

Features

• Run comprehensive Lighthouse audits on any URL
• Get performance scores and metrics
• Configure device emulation (mobile/desktop)
• Control network throttling
• Select specific audit categories

Installation

Option 1: From MCP Registry (Recommended)

This server is available in the Model Context Protocol Registry. Install it using your MCP client or Claude Desktop.

Option 2: Using npx

You can run the tool directly using npx without installation:

npx lighthouse-mcp

Option 3: Global Installation

Install the package globally from npm:

npm install -g lighthouse-mcp

Then run it:

lighthouse-mcp

Option 4: Local Development

1. Clone this repository
2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

4. Run the server:

   npm start
   

MCP Configuration

When installed via npm (global or npx)

Add the following to your MCP settings configuration file:

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

When using local development version

Add the following to your MCP settings configuration file:

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

Replace /absolute/path/to/lighthouse-mcp with the actual path to this project.

Available Tools

run_audit

Run a comprehensive Lighthouse audit on a URL.

Parameters:

• url (required): The URL to audit
• categories (optional): Array of categories to audit (defaults to all)
  • Options: “performance”, “accessibility”, “best-practices”, “seo”
• device (optional): Device to emulate (defaults to “mobile”)
  • Options: “mobile”, “desktop”
• throttling (optional): Whether to apply network throttling (defaults to true)

Example:

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

get_performance_score

Get just the performance score for a URL.

Parameters:

• url (required): The URL to audit
• device (optional): Device to emulate (defaults to “mobile”)
  • Options: “mobile”, “desktop”

Example:

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

Example Usage

Once the MCP server is configured, you can use it with Claude:

What's the performance score for example.com?

Claude will use the get_performance_score tool to analyze the website and return the results.

Requirements