PageSpeed MCP サーバー
PageSpeed Insights 機能により AI アシスタント機能を拡張する Model Context Protocol（MCP）サーバー。このサーバーは AI モデルと Google の PageSpeed Insights API 間の橋渡しとして機能し、ウェブサイトの詳細なパフォーマンス分析を可能にします。
概要
PageSpeed MCPサーバーは、AIアシスタントによる包括的なウェブパフォーマンス分析を可能にすることで、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"]
}
}
詳細な機能
パフォーマンスメトリック分析
- ファースト コンテンツ ペイント (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'
});
トラブルシューティング
よくある問題
- 接続タイムアウト
- APIレート制限
- メモリの問題
発達
ソースから構築
git clone https://github.com/phialsbasement/mcp-pagespeed-server
cd mcp-pagespeed-server
npm install
npm run build
テストの実行
貢献
- リポジトリをフォークする
- 機能ブランチを作成する
- 変更をコミットする
- ブランチにプッシュする
- プルリクエストを作成する
サポート
ヘルプの取得
- GitHub Issues: バグや機能リクエストを報告する
ライセンス
MITライセンス - 詳細はLICENSEファイルを参照