Ruchernchong MCP Server Google Analytics

🚀 Google Analytics 4 MCP サーバー

このサーバーは、Model Context Protocol (MCP) をベースに構築されており、TypeScript SDK を通じて Google Analytics 4 (GA4) のデータにアクセスできるようにします。

🚀 クイックスタート

Google Analytics 4 MCP サーバーは、Model Context Protocol (MCP) を利用して、TypeScript SDK 経由で Google Analytics 4 (GA4) のデータにアクセスするためのソリューションです。このサーバーを使うことで、GA4 のデータを柔軟に取得し、分析することができます。

✨ 主な機能

• カスタマイズ可能なディメンションでページビュー指標を取得する
• 一定期間のアクティブユーザーと新規ユーザーを追跡する
• 特定のイベントとその指標を分析する
• ユーザー行動指標（セッション時間、離脱率）を監視する
• すべてのクエリで柔軟な時間範囲選択をサポートする

📦 インストール

pnpm install mcp-server-google-analytics

💻 使用例

基本的な使用法

サーバーの起動

pnpm start

Claude Desktop での設定

Claude Desktop の設定に次の内容を追加します。

{
  "mcpServers": {
    "google-analytics": {
      "command": "npx",
      "args": ["-y", "mcp-server-google-analytics"],
      "env": {
        "GOOGLE_CLIENT_EMAIL": "your-service-account@project.iam.gserviceaccount.com",
        "GOOGLE_PRIVATE_KEY": "your-private-key",
        "GA_PROPERTY_ID": "your-ga4-property-id"
      }
    }
  }
}

高度な使用法

getPageViews

特定の期間のページビュー指標を取得します。

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": ["page", "country"] // オプション
}

getActiveUsers

アクティブユーザー指標を取得します。

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31"
}

getEvents

イベント指標を取得します。

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "eventName": "purchase" // オプション
}

getUserBehavior

ユーザー行動指標を取得します。

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31"
}

📚 ドキュメント

セキュリティに関する注意事項

• 常に環境変数を使用して機密情報を保存する
• 適切な CORS 設定を実施する
• 最小限の権限原則に従ってサービスアカウントの権限を設定する
• 定期的にサービスアカウントの認証情報を更新する
• API の使用状況を監視し、必要に応じてレート制限を実施する

プロジェクトへの貢献

貢献を歓迎します！コード規約と Pull Request の提出手順については、Contributing Guide をご覧ください。

📄 ライセンス

このプロジェクトは MIT License の下で公開されています。詳細については、LICENSE ファイルを参照してください。