Google Analytics MCP サーバー (実験的)

このリポジトリには、Google Analytics の API と対話するローカルの MCP サーバーを実行するためのソースコードが含まれています。

Discord の 🤖-analytics-mcp チャンネル で議論に参加したり、質問したりできます。

ツール 🛠️

このサーバーは Google Analytics Admin API および Google Analytics Data API を使用して、LLM で使用するためのいくつかの ツール を提供します。

アカウントとプロパティ情報の取得 🟠

• get_account_summaries: ユーザーの Google Analytics アカウントとプロパティに関する情報を取得します。

• get_property_details: プロパティの詳細を返します。

• list_google_ads_links: プロパティの Google 広告アカウントへのリンクのリストを返します。

コアレポートの実行 📙

• run_report: Data API を使用して Google Analytics レポートを実行します。

• run_funnel_report: Data API を使用して Google Analytics ファネルレポートを実行します。

• get_custom_dimensions_and_metrics: 特定のプロパティのカスタムディメンションと指標を取得します。

リアルタイムレポートの実行 ⏳

• run_realtime_report: Data API を使用して Google Analytics リアルタイムレポートを実行します。

Related MCP server: Google Analytics MCP Server

セットアップ手順 🔧

✨ YouTube の Google Analytics MCP セットアップチュートリアル で、これらの手順のステップバイステップの解説をご覧ください。

セットアップには以下の手順が含まれます。

1. Python の設定。

2. Google Analytics の認証情報の設定。

3. Gemini の設定。

Python の設定 🐍

pipx をインストール してください。

プロジェクトで API を有効にする ✅

手順に従って、Google Cloud プロジェクトで以下の API を有効にします。

• Google Analytics Admin API

• Google Analytics Data API

認証情報の設定 🔑

アプリケーションのデフォルト認証情報 (ADC) を設定します。認証情報が、Google Analytics アカウントまたはプロパティへのアクセス権を持つユーザーのものであることを確認してください。

認証情報には、Google Analytics の読み取り専用スコープが含まれている必要があります。

https://www.googleapis.com/auth/analytics.readonly

OAuth クライアントの作成方法については、OAuth クライアントの管理 を確認してください。

役立つ可能性のある gcloud コマンドの例をいくつか紹介します。

• クライアント JSON を YOUR_CLIENT_JSON_FILE にダウンロードした後、ユーザー認証情報と OAuth デスクトップまたは Web クライアントを使用して ADC を設定します。

  gcloud auth application-default login \
    --scopes https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform \
    --client-id-file=YOUR_CLIENT_JSON_FILE

• サービスアカウントのなりすましを使用して ADC を設定します。

  gcloud auth application-default login \
    --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
    --scopes=https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform

gcloud auth application-default コマンドが完了したら、コンソールに表示された PATH_TO_CREDENTIALS_JSON ファイルの場所をコピーします。次のステップでこれが必要になります！

Credentials saved to file: [PATH_TO_CREDENTIALS_JSON]

Gemini の設定

1. Gemini CLI または Gemini Code Assist をインストールします。

2. ~/.gemini/settings.json ファイルを作成または編集し、mcpServers リストにサーバーを追加します。

   PATH_TO_CREDENTIALS_JSON を、前のステップでコピーしたパスに置き換えてください。

   また、env オブジェクトに GOOGLE_CLOUD_PROJECT 属性を追加することをお勧めします。以下の例の YOUR_PROJECT_ID を、Google Cloud プロジェクトの プロジェクト ID に置き換えてください。

   {
     "mcpServers": {
       "analytics-mcp": {
         "command": "pipx",
         "args": ["run", "analytics-mcp"],
         "env": {
           "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
           "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID"
         }
       }
     }
   }

試してみる 🥼

Gemini Code Assist または Gemini CLI を起動し、/mcp と入力します。結果に analytics-mcp が表示されるはずです。

開始するためのサンプルプロンプトをいくつか紹介します。

• サーバーで何ができるか尋ねる:

  what can the analytics-mcp server do?

• Google Analytics プロパティについて尋ねる

  Give me details about my Google Analytics property with 'xyz' in the name

• 分析を依頼する:

  what are the most popular events in my Google Analytics property in the last 180 days?

• サインインしているユーザーについて尋ねる:

  were most of my users in the last 6 months logged in?

• プロパティ設定について尋ねる:

  what are the custom dimensions and custom metrics in my property?

貢献 ✨

貢献を歓迎します！貢献ガイド を参照してください。