PageSpeed MCP サーバー

PageSpeed Insights 機能により AI アシスタント機能を拡張する Model Context Protocol（MCP）サーバー。このサーバーは AI モデルと Google の PageSpeed Insights API 間の橋渡しとして機能し、ウェブサイトの詳細なパフォーマンス分析を可能にします。

概要

PageSpeed MCPサーバーは、AIアシスタントによる包括的なウェブパフォーマンス分析を可能にすることで、AIアシスタントの機能を強化するように設計されています。統合により、AIモデルは任意のURLについて、詳細なパフォーマンス指標、Core Web Vitals、その他の重要なウェブパフォーマンスデータを要求し、解釈できるようになります。

Related MCP server: Lighthouse MCP

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の PageSpeed Server を自動的にインストールするには:

npx -y @smithery/cli install mcp-pagespeed-server --client claude

手動インストール

npm install pagespeed-mcp-server

構成

PageSpeed MCP を AI アシスタント (この場合は claude) の構成ファイルに追加します。

{
    "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レート制限

• 無効なパラメータ

• サーバー側のエラー

要件

ネットワーク要件

• 安定したインターネット接続

• GoogleのPageSpeed Insights APIへのアクセス

プラットフォームサポート

• Windows (x64、x86)

• Linux (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 Issues: バグや機能リクエストを報告する

ライセンス

MITライセンス - 詳細はLICENSEファイルを参照