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.
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
- 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
- Verbindungstimeouts
- Überprüfen Sie die Internetverbindung
- API-Ratenbegrenzung
- Verwenden Sie den API-Schlüssel für höhere Limits
- 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
Beitragen
- Forken Sie das Repository
- Erstellen eines Feature-Zweigs
- Übernehmen Sie Ihre Änderungen
- Push zum Zweig
- Erstellen einer Pull-Anforderung
Unterstützung
Hilfe bekommen
- GitHub-Probleme: Fehler und Funktionsanfragen melden
Lizenz
MIT-Lizenz – Einzelheiten finden Sie in der Datei „LICENSE“