MCP-сервер PageSpeed

значок кузнеца

Сервер Model Context Protocol (MCP), который расширяет возможности помощника AI с помощью функциональности PageSpeed Insights. Этот сервер выступает в качестве моста между моделями AI и API PageSpeed Insights от Google, позволяя проводить подробный анализ производительности веб-сайтов.

Обзор

Сервер PageSpeed MCP предназначен для расширения возможностей помощников ИИ, позволяя им выполнять комплексный анализ веб-производительности. При интеграции модели ИИ могут запрашивать и интерпретировать подробные показатели производительности, основные веб-показатели и другие критические данные о веб-производительности для любого заданного URL.

Related MCP server: SEO AI Assistant

Установка

Установка через 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

Проведение тестов

npm run test

Внося вклад

Форк репозитория
Создать ветку функций
Примите ваши изменения
Нажмите на ветку
Создать запрос на извлечение

Поддерживать

Получение помощи

Проблемы GitHub: сообщайте об ошибках и запрашивайте новые функции

Лицензия

Лицензия MIT — подробности см. в файле LICENSE

PageSpeed MCP Server