remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Allows AI assistants to access Google's PageSpeed Insights API for detailed performance analysis of websites, including metrics like Core Web Vitals, performance scores, accessibility, best practices, and SEO audits

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レート制限
- 上限を上げるにはAPIキーを使用する
メモリの問題
- Node.jsのメモリ制限を調整する

発達

ソースから構築

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

テストの実行

npm run test

貢献

リポジトリをフォークする
機能ブランチを作成する
変更をコミットする
ブランチにプッシュする
プルリクエストを作成する

サポート

ヘルプの取得

GitHub Issues: バグや機能リクエストを報告する

ライセンス

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

AI モデルと Google のPageSpeed Insights API間の橋渡しとして機能し、ウェブサイトの詳細なパフォーマンス分析を可能にします。

PageSpeed MCP Server