Enemyrr MCP Server Pagespeed

🚀 @enemyrr/mcp-server-pagespeed

このモデルコンテキストプロトコル（MCP）サーバーは、Google PageSpeed Insights 分析を提供します。このサーバーは、統一インターフェースを通じて、AI モデルがウェブページのパフォーマンスを分析できるようにします。

🚀 クイックスタート

📦 インストール

Cursor IDE でのインストールと設定

1. プロジェクトをクローンしてビルドします：

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

2. Cursor IDE の設定にサーバーを追加します：
   • コマンドパネルを開きます（Cmd/Ctrl + Shift + P）
   • 「MCP: サーバーを追加」を検索します
   • 以下のフィールドを入力します：
     • 名前：pagespeed
     • タイプ：command
     • コマンド：node /絶対パス/to/mcp-server-pagespeed/build/index.js

⚠️ 重要提示

/absolute/path/to/ を、実際にクローンしてビルドしたプロジェクトのパスに置き換えてください。

コマンドラインでの使用

直接実行します：

npx mcp-server-pagespeed

💻 使用例

基本的な使用法

analyze_pagespeed

Google PageSpeed Insights API を使用してウェブページを分析します。

use_mcp_tool({
  server_name: "pagespeed",
  tool_name: "analyze_pagespeed",
  arguments: {
    url: "https://example.com"
  }
});

このツールは以下を返します：

• 全体的なパフォーマンススコア（0-100）
• ロード体験指標
  • 最初のコンテンツ描画時間（FCP）
  • 最初の入力遅延（FID）
• 上位5つの改善提案（以下を含む）：
  • タイトル
  • 説明
  • 潜在的な影響
  • 現在の値

✨ 主な機能

• ウェブページパフォーマンスのリアルタイム分析
• 詳細なロード体験指標
• 優先順位付けされた改善提案
• 詳細なエラー処理
• TypeScript サポート

🔧 技術詳細

エラー処理

このサーバーは、以下のケースに対して詳細なエラー情報を提供します：

• 無効な URL
• API リクエストの失敗
• 接続問題
• 無効なツール呼び出し

🤝 貢献ガイド

皆さんの貢献を歓迎します！自由に Pull Request を https://github.com/enemyrr/mcp-server-pagespeed に提出してください。

📄 ライセンス

MIT