eno-graph_mcp-server-google-analytics
3.2
If you are the rightful owner of eno-graph_mcp-server-google-analytics and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The Google Analytics Data API MCP Server provides an interface to access the Google Analytics Data API using the Model Context Protocol (MCP) server.
Google Analytics Data API MCP Server
Model Context Protocol (MCP) サーバーを使用して、Google Analytics Data APIにアクセスするためのインターフェースを提供します。
機能
このMCPサーバーは、Google Analytics Data APIの主要な機能にアクセスするためのツールとリソースを提供します：
ツール
- get_report: 指定した日付範囲、メトリクス、ディメンションに基づいてレポートを取得します
- get_realtime_data: リアルタイムデータを取得します
リソース
- ga4://property/{propertyId}/metadata: Google Analyticsプロパティのメタデータにアクセスします
セットアップ
前提条件
- Google Cloudプロジェクトを作成し、Analytics Data APIを有効にします
- サービスアカウントを作成し、認証情報JSONファイルをダウンロードします
- サービスアカウントにGA4プロパティへの適切なアクセス権を付与します
詳細なセットアップ手順については、を参照してください。
インストール
# リポジトリをクローン
git clone https://github.com/eno-graph/mcp-server-google-analytics.git
cd mcp-server-google-analytics
# 依存関係をインストール
npm install
# ビルド
npm run build
環境変数の設定
以下の環境変数を設定する必要があります：
export GOOGLE_CLIENT_EMAIL="your-service-account@project.iam.gserviceaccount.com"
export GOOGLE_PRIVATE_KEY="your-private-key"
export GA_PROPERTY_ID="your-ga4-property-id"
使用方法
サーバーの起動
npm start
または、提供されているスクリプトを使用することもできます：
./run-server.sh
Claude Desktopでの設定
Claude Desktopの設定ファイルに以下を追加します：
{
"mcpServers": {
"google-analytics": {
"command": "node",
"args": ["/path/to/mcp-server-google-analytics/build/index.js"],
"env": {
"GOOGLE_CLIENT_EMAIL": "your-service-account@project.iam.gserviceaccount.com",
"GOOGLE_PRIVATE_KEY": "your-private-key",
"GA_PROPERTY_ID": "your-ga4-property-id"
}
}
}
}
詳細な設定例については、を参照してください。
ツールの使用例
レポートの取得
get_report ツールを使用して、過去7日間のアクティブユーザー数とページビュー数を取得します。
引数:
{
"startDate": "7daysAgo",
"endDate": "today",
"metrics": ["activeUsers", "screenPageViews"],
"dimensions": ["date"],
"limit": 10
}
リアルタイムデータの取得
get_realtime_data ツールを使用して、現在アクティブなユーザー数を取得します。
引数:
{
"metrics": ["activeUsers"],
"dimensions": ["deviceCategory"],
"limit": 10
}
リソースの使用例
ga4://property/123456789/metadata リソースにアクセスして、利用可能なメトリクスとディメンションを確認します。
使用例
Claudeでの使用例については、を参照してください。
ライセンス
MIT
