MCP-сервер PageSpeed
Сервер Model Context Protocol (MCP), который расширяет возможности помощника AI с помощью функциональности PageSpeed Insights. Этот сервер выступает в качестве моста между моделями AI и API PageSpeed Insights от Google, позволяя проводить подробный анализ производительности веб-сайтов.
Обзор
Сервер PageSpeed MCP предназначен для расширения возможностей помощников ИИ, позволяя им выполнять комплексный анализ веб-производительности. При интеграции модели ИИ могут запрашивать и интерпретировать подробные показатели производительности, основные веб-показатели и другие критические данные о веб-производительности для любого заданного URL.
Установка
Установка через Smithery
Чтобы автоматически установить PageSpeed Server для Claude Desktop через Smithery :
npx -y @smithery/cli install mcp-pagespeed-server --client claude
Ручная установка
npm install pagespeed-mcp-server
Конфигурация
Добавьте PageSpeed MCP в файл конфигурации вашего ИИ-помощника (в данном случае Клода):
{
"pagespeed": {
"command": "node",
"args": ["path/to/mcp-pagespeed-server/dist/index.js"]
}
}
Подробные возможности
Анализ показателей производительности
- Первая контентная отрисовка (FCP)
- Самая большая содержательная краска (LCP)
- Время до интерактивности (TTI)
- Общее время блокировки (TBT)
- Накопительный сдвиг компоновки (CLS)
- Индекс скорости
- Время до первого байта (TTFB)
Оценка передового опыта
- Использование HTTPS
- Мониторинг ошибок JavaScript
- Предупреждения консоли браузера
- Устаревшее использование API
- Анализ соотношения сторон изображения
- Проверка безопасности ссылок
SEO-анализ
- Проверка метаописания
- Проверка robots.txt
- Проверка структурированных данных
- Проверка ссылок, доступных для сканирования
- Оценка метатегов
- Мобильная дружелюбность
Аудит доступности
- Проверка атрибутов ARIA
- Проверка цветового контраста
- Анализ иерархии заголовков
- Проверка альтернативного текста
- Оценка управления фокусом
- Тестирование навигации с помощью клавиатуры
Оптимизация ресурсов
- Предложения по оптимизации изображения
- Анализ связывания JavaScript
- Рекомендации по оптимизации CSS
- Проверка политики кэширования
- Проверки минимизации ресурсов
- Идентификация ресурсов, блокирующих рендеринг
Структура ответа API
Сервер MCP предоставляет подробные ответы JSON, включая:
{
"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
}
}
}
Расширенное использование
Индивидуальная конфигурация
Вы можете настроить анализ PageSpeed, указав дополнительные параметры:
{
"strategy": "mobile", // or "desktop"
"category": ["performance", "accessibility", "best-practices", "seo"],
"locale": "en",
"threshold": {
"performance": 90,
"accessibility": 100,
"best-practices": 90,
"seo": 90
}
}
Обработка ошибок
Сервер MCP включает в себя надежную обработку ошибок для:
- Недействительные URL-адреса
- Сетевые тайм-ауты
- Ограничение скорости API
- Неверные параметры
- Ошибки на стороне сервера
Требования
Требования к сети
- Стабильное интернет-соединение
- Доступ к API PageSpeed Insights от Google
- Windows (x64, x86)
- Линукс (x64)
- macOS (x64, arm64)
Примеры интеграции
Базовая интеграция
const PageSpeedMCP = require('pagespeed-mcp-server');
const mcp = new PageSpeedMCP();
await mcp.analyze('https://example.com');
С пользовательскими опциями
const results = await mcp.analyze('https://example.com', {
strategy: 'mobile',
categories: ['performance', 'accessibility'],
locale: 'en-US'
});
Поиск неисправностей
Общие проблемы
- Тайм-ауты соединения
- Проверьте подключение к Интернету
- Ограничение скорости API
- Используйте ключ API для более высоких лимитов
- Проблемы с памятью
- Настройте ограничения памяти Node.js
Разработка
Строительство из источника
git clone https://github.com/phialsbasement/mcp-pagespeed-server
cd mcp-pagespeed-server
npm install
npm run build
Проведение тестов
Внося вклад
- Форк репозитория
- Создать ветку функций
- Примите ваши изменения
- Нажмите на ветку
- Создать запрос на извлечение
Поддерживать
Получение помощи
- Проблемы GitHub: сообщайте об ошибках и запрашивайте новые функции
Лицензия
Лицензия MIT — подробности см. в файле LICENSE