PageSpeed MCP 서버

PageSpeed Insights 기능을 통해 AI 어시스턴트 기능을 확장하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 AI 모델과 Google PageSpeed Insights API를 연결하는 다리 역할을 하여 웹사이트의 상세한 성능 분석을 가능하게 합니다.

개요

PageSpeed MCP 서버는 AI 어시스턴트가 포괄적인 웹 성능 분석을 수행할 수 있도록 지원하여 AI 어시스턴트의 역량을 향상시키도록 설계되었습니다. 통합되면 AI 모델은 특정 URL에 대한 자세한 성능 지표, 핵심 웹 바이탈(Core Web Vitals) 및 기타 중요한 웹 성능 데이터를 요청하고 해석할 수 있습니다.

Related MCP server: Lighthouse MCP

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 PageSpeed Server를 자동으로 설치하려면:

지엑스피1

수동 설치

npm install pagespeed-mcp-server

구성

AI 어시스턴트(이 경우 Claude)의 구성 파일에 PageSpeed MCP를 추가합니다.

{
    "pagespeed": {
        "command": "node",
        "args": ["path/to/mcp-pagespeed-server/dist/index.js"]
    }
}

자세한 기능

성과 지표 분석

• 첫 번째 콘텐츠 페인트(FCP)

• 가장 큰 콘텐츠 페인트(LCP)

• 대화형 시간(TTI)

• 총 차단 시간(TBT)

• 누적 레이아웃 이동(CLS)

• 속도 지수

• 첫 번째 바이트까지의 시간(TTFB)

모범 사례 평가

• HTTPS 사용

• JavaScript 오류 모니터링

• 브라우저 콘솔 경고

• 더 이상 사용되지 않는 API 사용

• 이미지 종횡비 분석

• 링크 보안 검사

SEO 분석

• 메타 설명 검증

• Robots.txt 검증

• 구조화된 데이터 검증

• 크롤링 가능한 링크 검증

• 메타 태그 평가

• 모바일 친화성

접근성 감사

• ARIA 속성 검증

• 색상 대비 확인

• 제목 계층 분석

• 대체 텍스트 확인

• 집중 관리 평가

• 키보드 탐색 테스트

리소스 최적화

• 이미지 최적화 제안

• JavaScript 번들링 분석

• CSS 최적화 권장 사항

• 캐시 정책 검증

• 리소스 최소화 검사

• 렌더링 차단 리소스 식별

API 응답 구조

MCP 서버는 다음을 포함한 자세한 JSON 응답을 제공합니다.

{
    "lighthouseResult": {
        "categories": {
            "performance": { /* Performance metrics */ },
            "accessibility": { /* Accessibility results */ },
            "best-practices": { /* Best practices audit */ },
            "seo": { /* SEO findings */ }
        },
        "audits": {
            // Detailed audit results for each category
        },
        "timing": {
            // Performance timing data
        },
        "stackPacks": {
            // Technology-specific advice
        }
    }
}

고급 사용법

사용자 정의 구성

추가 매개변수를 제공하여 PageSpeed 분석을 사용자 정의할 수 있습니다.

{
    "strategy": "mobile", // or "desktop"
    "category": ["performance", "accessibility", "best-practices", "seo"],
    "locale": "en",
    "threshold": {
        "performance": 90,
        "accessibility": 100,
        "best-practices": 90,
        "seo": 90
    }
}

오류 처리

MCP 서버에는 다음에 대한 강력한 오류 처리 기능이 포함되어 있습니다.

• 잘못된 URL

• 네트워크 시간 초과

• API 속도 제한

• 잘못된 매개변수

• 서버 측 오류

요구 사항

네트워크 요구 사항

• 안정적인 인터넷 연결

• Google PageSpeed Insights API에 액세스

플랫폼 지원

• 윈도우(x64, x86)

• 리눅스(x64)

• macOS(x64, arm64)

통합 예제

기본 통합

const PageSpeedMCP = require('pagespeed-mcp-server');
const mcp = new PageSpeedMCP();

await mcp.analyze('https://example.com');

사용자 정의 옵션 포함

const results = await mcp.analyze('https://example.com', {
    strategy: 'mobile',
    categories: ['performance', 'accessibility'],
    locale: 'en-US'
});

문제 해결

일반적인 문제

1. 연결 시간 초과

   • 인터넷 연결을 확인하세요

2. API 속도 제한

   • 더 높은 한도를 위해 API 키를 사용하세요

3. 메모리 문제

   • Node.js 메모리 제한 조정

개발

소스에서 빌드

git clone https://github.com/phialsbasement/mcp-pagespeed-server
cd mcp-pagespeed-server
npm install
npm run build

테스트 실행

npm run test

기여하다

1. 저장소를 포크하세요

2. 기능 브랜치 생성

3. 변경 사항을 커밋하세요

4. 지점으로 밀어 넣기

5. 풀 리퀘스트 만들기

지원하다

도움 받기

• GitHub 문제: 버그 보고 및 기능 요청

특허

MIT 라이선스 - 자세한 내용은 라이선스 파일을 참조하세요.