PageSpeed MCP Server

Ein Model Context Protocol (MCP)-Server, der die Funktionen des KI-Assistenten um die PageSpeed Insights-Funktionalität erweitert. Dieser Server fungiert als Brücke zwischen KI-Modellen und der PageSpeed Insights API von Google und ermöglicht eine detaillierte Leistungsanalyse von Websites.

Überblick

Der PageSpeed MCP-Server erweitert die Fähigkeiten von KI-Assistenten und ermöglicht ihnen umfassende Web-Performance-Analysen. Integriert können KI-Modelle detaillierte Leistungskennzahlen, Core Web Vitals und andere wichtige Web-Performance-Daten für jede beliebige URL anfordern und interpretieren.

Related MCP server: Lighthouse MCP

Installation

Installation über Smithery

So installieren Sie PageSpeed Server für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install mcp-pagespeed-server --client claude

Manuelle Installation

npm install pagespeed-mcp-server

Konfiguration

Fügen Sie das PageSpeed MCP zur Konfigurationsdatei Ihres KI-Assistenten (in diesem Fall Claude) hinzu:

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

Detaillierte Funktionen

Analyse der Leistungsmetriken

• Erstes Contentful Paint (FCP)

• Größtes Contentful Paint (LCP)

• Zeit bis zur Interaktivität (TTI)

• Gesamtsperrzeit (TBT)

• Kumulative Layoutverschiebung (CLS)

• Geschwindigkeitsindex

• Zeit bis zum ersten Byte (TTFB)

Bewertung bewährter Verfahren

• HTTPS-Nutzung

• JavaScript-Fehlerüberwachung

• Warnungen der Browserkonsole

• Veraltete API-Nutzung

• Analyse des Bildseitenverhältnisses

• Link-Sicherheitsprüfungen

SEO-Analyse

• Validierung der Meta-Beschreibung

• Robots.txt-Validierung

• Strukturierte Datenvalidierung

• Überprüfung crawlbarer Links

• Bewertung von Meta-Tags

• Mobile-Freundlichkeit

Barrierefreiheitsprüfungen

• ARIA-Attributvalidierung

• Farbkontrastprüfung

• Überschriftenhierarchieanalyse

• Alt-Text-Verifizierung

• Fokusmanagement-Bewertung

• Testen der Tastaturnavigation

Ressourcenoptimierung

• Vorschläge zur Bildoptimierung

• JavaScript-Bündelungsanalyse

• Empfehlungen zur CSS-Optimierung

• Validierung der Cache-Richtlinie

• Überprüfungen zur Ressourcenminimierung

• Identifizierung renderblockierender Ressourcen

API-Antwortstruktur

Der MCP-Server bietet detaillierte JSON-Antworten, darunter:

{
    "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
        }
    }
}

Erweiterte Nutzung

Benutzerdefinierte Konfiguration

Sie können die PageSpeed-Analyse durch Angabe zusätzlicher Parameter anpassen:

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

Fehlerbehandlung

Der MCP-Server umfasst eine robuste Fehlerbehandlung für:

• Ungültige URLs

• Netzwerk-Timeouts

• API-Ratenbegrenzung

• Ungültige Parameter

• Serverseitige Fehler

Anforderungen

Netzwerkanforderungen

• Stabile Internetverbindung

• Zugriff auf die PageSpeed Insights API von Google

Plattformunterstützung

• Windows (x64, x86)

• Linux (x64)

• macOS (x64, arm64)

Integrationsbeispiele

Grundlegende Integration

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

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

Mit benutzerdefinierten Optionen

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

Fehlerbehebung

Häufige Probleme

1. Verbindungstimeouts

   • Überprüfen Sie die Internetverbindung

2. API-Ratenbegrenzung

   • Verwenden Sie den API-Schlüssel für höhere Limits

3. Speicherprobleme

   • Passen Sie die Speichergrenzen von Node.js an

Entwicklung

Erstellen aus der Quelle

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

Ausführen von Tests

npm run test

Beitragen

1. Forken Sie das Repository

2. Erstellen eines Feature-Zweigs

3. Übernehmen Sie Ihre Änderungen

4. Push zum Zweig

5. Erstellen einer Pull-Anforderung

Unterstützung

Hilfe bekommen

• GitHub-Probleme: Fehler und Funktionsanfragen melden

Lizenz

MIT-Lizenz – Einzelheiten finden Sie in der Datei „LICENSE“