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

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.

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

Tiempos de espera de conexión
- Comprobar la conectividad a Internet
Limitación de velocidad de API
- Utilice la clave API para límites más altos
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

Bifurcar el repositorio
Crear una rama de características
Confirme sus cambios
Empujar hacia la rama
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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Actúa como un 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.

PageSpeed MCP Server