priyankark/lighthouse-mcp

웹 페이지의 다양한 성능 지표 (performance metrics)를 측정할 수 있도록 Google의 Lighthouse 도구를 래핑(wrap)한 MCP 서버입니다.

• 모든 URL에 대해 종합적인 Lighthouse 감사 (audit) 실행
• 성능 점수 및 지표 획득
• 디바이스 에뮬레이션 (device emulation) 설정 (모바일/데스크톱)
• 네트워크 스로틀링 (network throttling) 제어
• 특정 감사 카테고리 선택

이 서버는 Model Context Protocol Registry에서 사용할 수 있습니다. MCP 클라이언트 또는 Claude Desktop을 사용하여 설치하세요.

설치 없이 npx를 사용하여 도구를 직접 실행할 수 있습니다:

npx lighthouse-mcp

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

npm install -g lighthouse-mcp

그 다음 실행하세요:

lighthouse-mcp

• 이 저장소(repository)를 클론(Clone)합니다.

• 의존성(dependencies) 설치:
  npm install

• 프로젝트 빌드:
  npm run build

• 서버 실행:
  npm start

MCP 설정 구성 파일에 다음을 추가하세요:

{
"mcpServers": {
"lighthouse": {
...

MCP 설정 구성 파일에 다음을 추가하세요:

{
"mcpServers": {
"lighthouse": {
...

/absolute/path/to/lighthouse-mcp를

이 프로젝트의 실제 경로로 교체하세요.

URL에 대해 종합적인 Lighthouse 감사를 실행합니다.

매개변수 (Parameters):

url

(필수): 감사할 URL
categories

(선택 사항): 감사할 카테고리 배열 (기본값은 전체)- 옵션: "performance", "accessibility", "best-practices", "seo", "pwa"

device

(선택 사항): 에뮬레이션할 디바이스 (기본값은 "mobile")- 옵션: "mobile", "desktop"

throttling

(선택 사항): 네트워크 스로틀링 적용 여부 (기본값은 true)

예시 (Example):

{
"url": "https://example.com",
"categories": ["performance", "accessibility"],
...

URL에 대한 성능 점수만 가져옵니다.

매개변수 (Parameters):

url

(필수): 감사할 URL
device

(선택 사항): 에뮬레이션할 디바이스 (기본값은 "mobile")- 옵션: "mobile", "desktop"

예시 (Example):

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

MCP 서버가 구성되면 Claude와 함께 사용할 수 있습니다:

example.com의 성능 점수는 얼마인가요?

Claude는 웹사이트를 분석하고 결과를 반환하기 위해 get_performance_score 도구 (tool)를 사용할 것입니다.

• Node.js 16+
• Chrome/Chromium 브라우저 (Lighthouse용)