Google アナリティクス MCP サーバー

Model Context Protocol TypeScript SDK を使用して構築された、Google アナリティクス 4 (GA4) データにアクセスするための MCP サーバー実装。

特徴

• カスタマイズ可能なディメンションでページビュー指標を取得

• アクティブユーザーと新規ユーザーを時間の経過とともに追跡する

• 特定のイベントとその指標を分析する

• ユーザー行動指標（セッション継続時間、直帰率）を監視する

• すべてのクエリに対して柔軟な日付範囲の選択

Related MCP server: Google Analytics Data API MCP Server

前提条件

• Node.js 20以上

• Google アナリティクス 4 プロパティ

• Analytics Data API が有効になっている Google Cloud プロジェクト

• 適切な権限を持つサービス アカウントの資格情報

設定

1. Google Cloud プロジェクトを作成し、Analytics Data API を有効にする

2. サービスアカウントを作成し、認証情報JSONファイルをダウンロードします

3. サービス アカウントに GA4 プロパティへの適切なアクセス権を付与します

4. 環境変数を設定します。

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"

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Google Analytics Server を自動的にインストールするには:

npx -y @smithery/cli install mcp-server-google-analytics --client claude

手動インストール

pnpm install mcp-server-google-analytics

使用法

サーバーの起動

pnpm start

Claude Desktopでの設定

Claude Desktop の構成にこれを追加します:

{
  "mcpServers": {
    "google-analytics": {
      "command": "npx",
      "args": ["-y", "mcp-server-google-analytics"],
      "env": {
        "GOOGLE_CLIENT_EMAIL": "your-service-account@project.iam.gserviceaccount.com",
        "GOOGLE_PRIVATE_KEY": "your-private-key",
        "GA_PROPERTY_ID": "your-ga4-property-id"
      }
    }
  }
}

利用可能な機能

ページビューを取得する

特定の日付範囲のページビュー指標を取得します。

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": ["page", "country"] // Optional
}

アクティブユーザーを取得する

アクティブユーザーのメトリクスを取得します。

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31"
}

取得イベント

イベント メトリックを取得します。

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "eventName": "purchase" // Optional
}

getUserBehavior

ユーザー行動のメトリクスを取得します。

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31"
}

セキュリティに関する考慮事項

• 機密性の高い認証情報には常に環境変数を使用する

• 適切なCORS設定を実装する

• サービス アカウントの権限を設定するときは、最小権限の原則に従ってください。

• サービスアカウントの認証情報を定期的にローテーションする

• APIの使用状況を監視し、必要に応じてレート制限を実装する

貢献

貢献を歓迎します！行動規範とプルリクエストの送信手順の詳細については、貢献ガイドをお読みください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。