MCP Server Ga4

これは、Google Analytics 4にMCPサービスを提供するサーバープロジェクトで、データ取得、リソースクエリ、データ分析などの機能が含まれており、Googleサービスアカウントで認証して使用する必要があります。

研究とデータマーケティング #データ分析 #GA4インターフェイス #データレポート #ユーザー行動ローカル .TypeScript

スコア : 2.5ポイント

ダウンロード数 : 4.6K

更新時間 : 2025-04-29

サイトを開く

MCPサーバーとは？

MCPサーバーは、Model Context Protocolに基づくツールで、Google Analytics 4 (GA4) のデータを接続して操作するために特別に設計されています。これにより、ページビュー数、アクティブユーザー数、イベントデータなど、さまざまな指標とディメンションのデータを簡単に取得できます。

MCPサーバーの使い方は？

シンプルなコマンドラインインターフェイスを通じて、GA4のデータをすばやくクエリして分析できます。数ステップの設定と構成を行うだけで、使用を開始できます。

適用シナリオ

定期的にウェブサイトのトラフィック、ユーザー行動、マーケティングキャンペーンの効果を監視する必要がある企業やチームに適しています。

主要機能

ページビュー数を取得

指定された日付範囲に基づいて、ウェブサイトのページビュー数のデータを取得します。

アクティブユーザー数を取得

指定された日付範囲内のアクティブユーザー数を集計します。

イベントデータを取得

ユーザーがウェブサイト上で行ったクリックボタンやフォーム送信などのインタラクションイベントを分析します。

ユーザー行動を取得

ユーザーのセッション時間や離脱率などの行動指標を分析します。

属性情報を取得

GA4属性の利用可能なディメンション、指標、比較オプションを確認します。

データをフィルタリングおよび選別

複数の条件でデータを選別し、結果を正確にすることができます。

利点

Google Analytics 4のデータに迅速にアクセスできる

複数のデータクエリと分析機能をサポートする

既存のワークフローに簡単に統合できる

詳細なフィルタリングとページング機能を提供する

制限

正しいGoogleサービスアカウントの権限が必要です

データクエリはAPIの制限の影響を受ける可能性があります

構成には一定の技術的背景が必要です

使い方

インストールと構成

READMEの説明に従ってリポジトリをクローンし、依存関係をインストールします。

環境変数を設定

.envファイルを作成し、必要な構成を記入します。

サーバーを起動

MCPサーバーを起動し、接続を検証します。

使用例

例1: ページビュー数を取得

特定の日付範囲内のページビュー数をクエリします。

例2: ユーザー行動レポートを生成

ユーザーのセッション時間や離脱率などの行動パターンを分析します。

よくある質問

認証エラーを解決するにはどうすればいいですか？

データが表示されないのはなぜですか？

接続エラーを処理するにはどうすればいいですか？

🚀 Google Analytics 4のMCPサーバー

このサーバーはGoogle Analytics 4のMCP機能を提供し、指定日付範囲内の各種指標を取得することができます。

🚀 クイックスタート

このサーバーは進行中のプロジェクトです。サーバーはまだ完全にテストされていないため、慎重に使用してください。

✨ 主な機能

このサーバーは以下のMCP機能を提供します。

ツール

get-page-views：指定日付範囲内のページビュー指標を取得します。
get-active-users：指定日付範囲内のアクティブユーザー指標を取得します。
get-events：指定日付範囲内のイベント指標を取得します。
get-user-behavior：ユーザー行動指標（セッション時間や離脱率など）を取得します。

リソース

ga4://property-info：GA4プロパティのメタデータ（利用可能なディメンション、指標、比較項目を含む）。

以下はより軽量なリソースです。

ga4://dimensions：GA4で利用可能なディメンションのリスト。
ga4://filters-help：GA4フィルターの使用に関するヘルプドキュメント。
ga4://metrics：GA4で利用可能な指標のリスト。

ヒント

analyze-data：データ分析アシスタント。
create-report：レポート生成テンプレート。
select-dimensions：分析目標に適したディメンションの選択を支援します。

📦 インストール

前提条件

Google Analytics 4のプロパティ。
GA4 APIへのアクセス権限を持つGoogle Cloudのサービスアカウント。
Node.js 20以上。
pnpmパッケージマネージャー。

インストール手順

# リポジトリをクローン
git clone https://github.com/yourusername/mcp-server-ga4.git
cd mcp-server-ga4

# pnpmを使用して依存関係をインストール
pnpm install

# .envファイルを作成
cp .env.example .env

# .envファイルを編集し、認証情報を設定
# GOOGLE_CLIENT_EMAIL=your-service-account-email@example.iam.gserviceaccount.com
# GOOGLE_PRIVATE_KEY=your-private-key
# GA_PROPERTY_ID=your-ga4-property-id

認証

GOOGLE_CLIENT_EMAIL と GOOGLE_PRIVATE_KEY を設定すると、サーバーはサービスアカウントを使用して認証します。設定されていない場合は、デフォルトでアプリケーションのデフォルト認証情報が使用されます。

プロジェクトで Google Analytics API が有効になっていること、およびサービスアカウントに必要な権限（https://www.googleapis.com/auth/analytics.readonly）があることを確認してください。

以下はGoogleアプリケーションのデフォルト認証情報を設定する方法です。

Google Cloud SDKをインストールします。
以下のコマンドを実行して認証します。

gcloud auth application-default login

💻 使用例

リソースパスの例

ga4://property-info：GA4プロパティのメタデータ（利用可能なディメンション、指標、比較項目を含む）を取得します。
ga4://dimensions：GA4のすべての利用可能なディメンションをリストします。
ga4://metrics：GA4のすべての利用可能な指標をリストします。

ヒント機能の例

analyze-data：データ分析を支援し、洞察を提供します。
create-report：カスタムレポートテンプレートを生成します。
select-dimensions：目標に合った最適なディメンションを選択します。

トラブルシューティング

認証エラー：サービスアカウントのキーと権限を確認してください。
データが表示されない：日付範囲とプロパティIDが正しいことを確認してください。
接続エラー：ネットワーク設定とファイアウォール構成を確認してください。

テスト

MCPチェッカーを使用してテストします。

pnpm dlx @modelcontextprotocol/inspector node /path/to/mcp-server-ga4/dist/index.js

(注意：pnpm dlx はパッケージを実行するための npx と同等です)

📄 ライセンス

MIT

🎉 謝辞

https://github.com/lapras-inc/lapras-mcp-server/tree/main
- このプロジェクトはこのリポジトリのクラス構造の実装を参考にしています。
https://github.com/ruchernchong/mcp-server-google-analytics
- Google Analytics APIに基づく基本的な実装。