PageSpeed MCP Server

PageSpeed MCP Server

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

概要

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

インストール

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"],
        "env": {
           "GOOGLE_API_KEY": "<YOUR-API-KEY>"
        }
    }
}

詳細な機能

パフォーマンス指標の分析

• First Contentful Paint（FCP）
• Largest Contentful Paint（LCP）
• Time to Interactive（TTI）
• Total Blocking Time（TBT）
• Cumulative Layout Shift（CLS）
• Speed Index
• Time to First Byte（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. Pull Request を作成します

サポート

ヘルプの利用

• GitHub Issues：バグや機能リクエストを報告します

ライセンス

MIT License - 詳細については LICENSE ファイルを参照してください