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
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
- 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
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