Googleanalytics MCP Server

🚀 Google Analytics データ API MCP サーバー

このサーバーは、Google Analytics データ API v1 とのインタラクションを行うためのモデルコンテキストプロトコル（MCP）サーバーです。Google Analytics データのクエリ、オーディエンスの管理、メタデータへのアクセスなどのツールやリソースを提供します。

✨ 主な機能

• 標準レポートとピボットテーブルレポートの実行
• レポートのバッチ処理機能
• ディメンションとメトリクスのメタデータへのアクセス
• オーディエンスの作成、一覧表示、更新、削除
• ディメンションとメトリクス間の互換性のチェック
• GA データを探索するための包括的なリソースエンドポイントの提供

📦 インストール

前提条件

• Node.js 14 以上
• Google Analytics 4 アカウント属性
• 適切な権限を持つ Google Cloud サービスアカウント

インストール手順

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

   npm install
   

3. .env.example を元に .env ファイルを作成し、Google Analytics の認証情報を記入します。

   GOOGLE_CLIENT_EMAIL=your-service-account-email@project-id.iam.gserviceaccount.com
   GOOGLE_PRIVATE_KEY=your-private-key
   DEFAULT_PROPERTY_ID=properties/123456789
   

💻 使用例

サーバーの起動

npm start

MCP チェックツールを使用したテスト

npm run inspect

基本的な使用法

// 基本レポートの実行
{
  "propertyId": "properties/123456789",
  "dateRanges": [
    {
      "startDate": "7daysAgo",
      "endDate": "yesterday"
    }
  ],
  "dimensions": [
    {
      "name": "country"
    },
    {
      "name": "deviceCategory"
    }
  ],
  "metrics": [
    {
      "name": "activeUsers"
    },
    {
      "name": "sessions"
    }
  ]
}

高度な使用法

// オーディエンスの作成
{
  "propertyId": "properties/123456789",
  "displayName": "High Value Users",
  "description": "Users who have completed a purchase",
  "membershipDurationDays": 30,
  "filterClauses": [
    {
      "filterExpression": {
        "andGroup": {
          "expressions": [
            {
              "filter": {
                "fieldName": "eventName",
                "stringFilter": {
                  "value": "purchase",
                  "matchType": "EXACT"
                }
              }
            }
          ]
        }
      }
    }
  ]
}

📚 ドキュメント

利用可能なツール

• runReport：Google Analytics データの標準レポートを実行します。
• batchRunReports：複数のレポートをバッチで実行します。
• runPivotReport：ピボットテーブル付きのレポートを実行します。
• batchRunPivotReports：ピボットテーブル付きのレポートをバッチで実行します。
• getMetadata：ディメンションとメトリクスのメタデータを取得します。
• checkCompatibility：ディメンションとメトリクス間の互換性をチェックします。
• createAudience：新しいオーディエンスを作成します。
• listAudiences：特定のプロパティ下のすべてのオーディエンスを一覧表示します。
• getAudience：特定のオーディエンスの詳細情報を取得します。
• deleteAudience：特定のオーディエンスを削除します。
• updateAudience：既存のオーディエンスを更新します。

利用可能なリソース

• ga://property/{propertyId}：プロパティ情報を取得します。
• ga://report/{propertyId}/{reportType}/{dimensions}/{metrics}/{startDate}/{endDate}：レポートを生成します。
• ga://metadata：API のメタデータを取得します。
• ga://dimensions：カテゴリ別にディメンションを閲覧します。
• ga://dimensions/{category}：特定のカテゴリのすべてのディメンションを取得します。
• ga://metrics：カテゴリ別にメトリクスを閲覧します。
• ga://metrics/{category}：特定のカテゴリのすべてのメトリクスを取得します。
• ga://audiences/{propertyId}：特定のプロパティ下のすべてのオーディエンスを一覧表示します。
• ga://audiences/{propertyId}/{audienceId}：特定のオーディエンスの詳細情報を取得します。

📄 ライセンス

[ここにライセンス情報を記入]

貢献者

[貢献者をここに記載]

バージョン履歴

[バージョン履歴をここに追加]