MCP-сервер PageSpeed

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

Обзор

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

Related MCP server: Lighthouse MCP

Установка

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

Поиск неисправностей

Общие проблемы

1. Тайм-ауты соединения

   • Проверьте подключение к Интернету

2. Ограничение скорости API

   • Используйте ключ API для более высоких лимитов

3. Проблемы с памятью

   • Настройте ограничения памяти Node.js

Разработка

Строительство из источника

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

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

npm run test

Внося вклад

1. Форк репозитория

2. Создать ветку функций

3. Примите ваши изменения

4. Нажмите на ветку

5. Создать запрос на извлечение

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

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

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

Лицензия

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