ga4-dashboard-mcp

GA4 Dashboard & MCPは、自己ホスト型のリアルタイムGoogle Analytics 4ダッシュボードおよびオプションのModel Context Protocol（MCP）サーバーです。 ## ダッシュボード機能 - **リアルタイム分析**: アクティブユーザーのライブ監視、プロパティ比較、トラフィックレシピ、APIクォータ追跡。 - **3Dインタラクティブグローブ**: Three.jsを使用して世界中の国々におけるライブサイト活動を可視化。`/globe`でアクセス可能。 - **トラフィックスパイク検出**: 突発的な急増を自動検出し、リファラー、ダイレクト、キャンペーンとしてソースを分類。 - **訪問者インサイト**: 新規・再訪問者のペルソナカード、デバイス別内訳、主要地域。 - **プライバシーシールド**: ダッシュボード上でデータ漏洩を防ぐため、フルURLパラメータとクエリストリングをマスク。 - **スマートキャッシュ**: ィスクおよびメモリキャッシュ層と、GA4 APIクォータを節約するバックグラウンドでのプロパティメタデータ自動更新。 - **初回セットアップページ**: 証明書がない場合、ブラウザ内セットアップフローにリダイレクト。 ## MCPサーバー 独立した`mcp-server/`パッケージは、Claude Desktop、Antigravity、CursorなどのMCP対応クライアント向けにGA4 AdminおよびData APIツールを公開。ダッシュボードとは独立動作し、独自の依存関係と認証情報を有します。 ## 前提条件 - Node.js v18.0.0+ - pnpmパッケージマネージャー - Google Analytics Data APIおよびAdmin APIへのアクセス権を持つGoogle Cloud Platformサービスアカウント ## セットアップ概要 1. リポジトリをクローンし、`pnpm install`を実行。 2. Google Cloudサービスアカウントを作成し、必要なAPIを有効化、JSONキーファイルを生成。 3. サービスアカウントにGA4プロパティのViewerアクセス権を付与し、JSONキーをプロジェクトルートに配置（または`.env`で`GA4_CREDENTIALS_PATH`を設定）。 4. `pnpm dev`（開発）または`pnpm start`（本番）でアプリを起動。 5. オプション: `.env.example`をコピーし、`GOOGLE_APPLICATION_CREDENTIALS`をキー・ファイルへ指向、MCPクライアント設定にサーバーを追加。 ## URL - メインダッシュボード: `http://localhost:3000` - 3Dグローブ: `http://localhost:3000/globe` - 分析ビュー: `http://localhost:3000/analytics` ## テスト・ビルド `pnpm test`でMocha単体テストスイートを実行、`pnpm build`でTypeScriptコンパイルチェック。 MITライセンスの下で配布。