MCP Server Google Analytics

🚀 谷歌分析数据API MCP サーバー

モデルコンテキストプロトコル（MCP）サーバーは、Google Analytics Data APIへのアクセス用のインターフェースを提供します。

✨ 主な機能

このMCPサーバーは、Google Analytics Data APIの主要機能にアクセスするためのツールとリソースを提供します。

ツール

• get_report: 指定された日付範囲、指標、次元に基づいてレポートを取得します。
• get_realtime_data: リアルタイムデータを取得します。

リソース

• ga4://property/{propertyId}/metadata: Google Analyticsプロパティのメタデータにアクセスします。

📦 インストール

前提条件

1. Google Cloudプロジェクトを作成し、Analytics Data APIを有効にします。
2. サービスアカウントを作成し、認証情報のJSONファイルをダウンロードします。
3. サービスアカウントに対応する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デスクトップの設定ファイルに以下の内容を追加します。

{
  "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"
      }
    }
  }
}

詳細な設定例については、claude-desktop-config-sample.jsonを参照してください。

ツールの使用例

基本的な使用法

レポートの取得

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での使用例

Claudeでの使用例については、Claude使用例を参照してください。

📄 ライセンス

MIT