remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Allows AI assistants to access Google's PageSpeed Insights API for detailed performance analysis of websites, including metrics like Core Web Vitals, performance scores, accessibility, best practices, and SEO audits

PageSpeed MCP 서버

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

개요

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

설치

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'
});

문제 해결

일반적인 문제

연결 시간 초과
- 인터넷 연결을 확인하세요
API 속도 제한
- 더 높은 한도를 위해 API 키를 사용하세요
메모리 문제
- Node.js 메모리 제한 조정

개발

소스에서 빌드

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

테스트 실행

npm run test

기여하다

저장소를 포크하세요
기능 브랜치 생성
변경 사항을 커밋하세요
지점으로 밀어 넣기
풀 리퀘스트 만들기

지원하다

도움 받기

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

특허

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

AI 모델과 Google PageSpeed Insights API 사이의 다리 역할을 하여 웹사이트의 세부적인 성능 분석을 가능하게 합니다.

PageSpeed MCP Server