What is Mcp Server Google Analytics

mcp-server-google-analytics is a Model Context Protocol (MCP) server that provides an interface to access the Google Analytics Data API, enabling users to retrieve analytics data efficiently.

Use cases

Use cases include generating reports on user activity over specific periods, obtaining real-time user metrics, and integrating Google Analytics data into other applications or dashboards.

How to use

To use mcp-server-google-analytics, set up a Google Cloud project with the Analytics Data API enabled, create a service account, and configure the necessary environment variables. Then, start the server using npm commands or provided scripts.

Key features

Key features include tools for retrieving reports based on specified date ranges, metrics, and dimensions, as well as obtaining real-time data. It also provides access to Google Analytics property metadata.

Where to use

mcp-server-google-analytics can be used in web analytics, digital marketing, and data analysis fields, where access to Google Analytics data is required for decision-making and reporting.

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プロパティのメタデータにアクセスします

セットアップ

前提条件

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="[email protected]"
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": "[email protected]",
        "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