Pagespeed MCP Server

🚀 PageSpeed MCP サーバー

AI アシスタントの機能を強化するモデルコンテキストプロトコル（MCP）サーバーで、PageSpeed Insights 機能を統合しています。このサーバーは、AI モデルと Google の PageSpeed Insights API の間の橋渡しとして機能し、ウェブサイトのパフォーマンスを詳細に分析します。

🚀 クイックスタート

PageSpeed MCP サーバーは、AI アシスタントの機能を向上させ、包括的なネットワークパフォーマンス分析を実行できるようにすることを目的としています。統合後、AI モデルは指定された URL の詳細なパフォーマンス指標、コアウェブバイタル（Core Web Vitals）、その他の重要なネットワークパフォーマンスデータを要求して解析することができます。

✨ 主な機能

性能指標分析

• 最初のコンテンツペイント（FCP）
• 最大コンテンツペイント（LCP）
• インタラクション時間（TTI）
• 総ブロッキング時間（TBT）
• レイアウト偏移累積（CLS）
• Speed Index 指数
• 最初のバイトの時間（TTFB）

ベストプラクティス評価

• HTTPS 使用状況
• JavaScript エラー監視
• ブラウザコンソール警告
• 廃止された API の使用
• 画像のアスペクト比分析
• リンクのセキュリティチェック

SEO 分析

• Meta 説明の検証
• Robots.txt ファイルの検証
• 構造化データの検証
• クロール可能なリンクの検証
• Meta タグの評価
• モバイルデバイスの使いやすさ検出

アクセシビリティ監査

• ARIA 属性の検証
• 色のコントラストチェック
• 見出しの階層構造分析
• alt テキストの検証
• フォーカス管理の評価
• キーボードナビゲーションのテスト

リソース最適化

• 画像最適化の提案
• JavaScript パッケージ分析
• CSS 最適化の推奨
• キャッシュポリシーの検証
• リソースの最小化チェック
• レンダリングブロッキングリソースの識別

📦 インストール

Smithery を使用したインストール

Smithery を通じて、Claude Desktop の PageSpeed サーバーを自動的にインストールします。

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"]
    }
}

API 応答構造

MCP サーバーは、詳細な JSON 応答を提供します。

{
    "lighthouseResult": {
        "categories": {
            "performance": { /* 性能指標 */ },
            "accessibility": { /* アクセシビリティ結果 */ },
            "best-practices": { /* ベストプラクティス評価 */ },
            "seo": { /* SEO 分析 */ }
        },
        "details": {
            "performanceMetrics": [/* 性能指標の詳細 */],
            "accessibilityIssues": [/* アクセシビリティの問題 */],
            "optimizationSuggestions": [/* 最適化の提案 */]
        }
    }
}

高度な使用法

カスタム設定

設定ファイルにカスタム設定を追加します。

{
    "pagespeed": {
        "command": "node",
        "args": ["path/to/mcp-pagespeed-server/dist/index.js"],
        "config": {
            "performanceThreshold": 90,
            "accessibilityScore": "AA"
        }
    }
}

エラー処理

発生する可能性のあるエラーを処理します。

try {
    const result = await pagespeed.analyze(url);
    console.log(result);
} catch (error) {
    console.error("分析に失敗しました:", error.message);
}

要件

• プラットフォームサポート: Windows、Linux、macOS システムをサポートしています。
• Node.js バージョン: Node.js 14 以上が必要です。

ヘルプの取得

サポートが必要な場合は、GitHub Issues で問題や機能要求を報告してください。

📄 ライセンス

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