Google Analytics Data API MCP Server

Google Analytics Data API MCP サーバー

Google Analytics Data API v1 と連携するための Model Context Protocol（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 Inspector でのテスト

```
npm run inspect
```

## 利用可能なツール

- **runReport**：Google Analytics データの標準レポートを実行
- **batchRunReports**：複数のレポートを1回のバッチで実行
- **runPivotReport**：Google Analytics データのピボットレポートを実行
- **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}**：特定のオーディエンスの詳細を取得

## クエリ例

### 基本的なレポートの実行

```javascript
{
  "propertyId": "properties/123456789",
  "dateRanges": [
    {
      "startDate": "7daysAgo",
      "endDate": "yesterday"
    }
  ],
  "dimensions": [
    {
      "name": "country"
    },
    {
      "name": "deviceCategory"
    }
  ],
  "metrics": [
    {
      "name": "activeUsers"
    },
    {
      "name": "sessions"
    }
  ]
}
```

### オーディエンスの作成

```javascript
{
  "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"
                }
              }
            }
          ]
        }
      }
    }
  ]
}
```

## ライセンス

MIT