Servidor MCP de PageSpeed

Un servidor de Protocolo de Contexto de Modelo (MCP) que amplía las capacidades del asistente de IA con la funcionalidad de PageSpeed Insights. Este servidor actúa como puente entre los modelos de IA y la API PageSpeed Insights de Google, lo que permite un análisis detallado del rendimiento de los sitios web.

Descripción general

El servidor MCP de PageSpeed está diseñado para optimizar las capacidades de los asistentes de IA, permitiéndoles realizar análisis exhaustivos del rendimiento web. Al integrarse, los modelos de IA pueden solicitar e interpretar métricas de rendimiento detalladas, Core Web Vitals y otros datos críticos de rendimiento web para cualquier URL.

Related MCP server: Lighthouse MCP

Instalación

Instalación mediante herrería

Para instalar PageSpeed Server para Claude Desktop automáticamente a través de Smithery :

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

Instalación manual

npm install pagespeed-mcp-server

Configuración

Añade el MCP de PageSpeed al archivo de configuración de tu asistente de IA (Claude en este caso):

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

Capacidades detalladas

Análisis de métricas de rendimiento

• Primera pintura con contenido (FCP)

• Pintura con contenido más grande (LCP)

• Tiempo de interacción (TTI)

• Tiempo total de bloqueo (TBT)

• Cambio de diseño acumulativo (CLS)

• Índice de velocidad

• Tiempo hasta el primer byte (TTFB)

Evaluación de mejores prácticas

• Uso de HTTPS

• Monitoreo de errores de JavaScript

• Advertencias de la consola del navegador

• Uso de API obsoleto

• Análisis de la relación de aspecto de la imagen

• Comprobaciones de seguridad de enlaces

Análisis SEO

• Validación de metadescripciones

• Validación de robots.txt

• Validación de datos estructurados

• Verificación de enlaces rastreables

• Evaluación de metaetiquetas

• Compatibilidad con dispositivos móviles

Auditorías de accesibilidad

• Validación de atributos ARIA

• Comprobación del contraste de color

• Análisis de jerarquía de encabezados

• Verificación de texto alternativo

• Evaluación de la gestión del enfoque

• Prueba de navegación con teclado

Optimización de recursos

• Sugerencias de optimización de imágenes

• Análisis de agrupación de JavaScript

• Recomendaciones de optimización de CSS

• Validación de la política de caché

• Comprobaciones de minimización de recursos

• Identificación de recursos que bloquean la representación

Estructura de respuesta de la API

El servidor MCP proporciona respuestas JSON detalladas que incluyen:

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

Uso avanzado

Configuración personalizada

Puede personalizar el análisis de PageSpeed proporcionando parámetros adicionales:

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

Manejo de errores

El servidor MCP incluye un manejo robusto de errores para:

• URL no válidas

• Tiempos de espera de la red

• Limitación de velocidad de API

• Parámetros no válidos

• Errores del lado del servidor

Requisitos

Requisitos de red

• Conexión a Internet estable

• Acceso a la API PageSpeed Insights de Google

Soporte de plataforma

• Ventanas (x64, x86)

• Linux (x64)

• macOS (x64, arm64)

Ejemplos de integración

Integración básica

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

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

Con opciones personalizadas

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

Solución de problemas

Problemas comunes

1. Tiempos de espera de conexión

   • Comprobar la conectividad a Internet

2. Limitación de velocidad de API

   • Utilice la clave API para límites más altos

3. Problemas de memoria

   • Ajustar los límites de memoria de Node.js

Desarrollo

Construyendo desde la fuente

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

Ejecución de pruebas

npm run test

Contribuyendo

1. Bifurcar el repositorio

2. Crear una rama de características

3. Confirme sus cambios

4. Empujar hacia la rama

5. Crear una solicitud de extracción

Apoyo

Obtener ayuda

• Problemas de GitHub: Informar errores y solicitudes de funciones

Licencia

Licencia MIT: consulte el archivo LICENCIA para obtener más detalles