Eno Graph MCP Server Google Analytics

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

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

🚀 クイックスタート

この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 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"
      }
    }
  }
}

詳細な設定例については、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使用例を参照してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。