remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides access to Google Analytics 4 (GA4) data, allowing retrieval of page view metrics, active and new user tracking, event analysis, and user behavior metrics (session duration, bounce rate) with customizable dimensions and date ranges.

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

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

特徴

カスタマイズ可能なディメンションでページビュー指標を取得
アクティブユーザーと新規ユーザーを時間の経過とともに追跡する
特定のイベントとその指標を分析する
ユーザー行動指標（セッション継続時間、直帰率）を監視する
すべてのクエリに対して柔軟な日付範囲の選択

前提条件

Node.js 20以上
Google アナリティクス 4 プロパティ
Analytics Data API が有効になっている Google Cloud プロジェクト
適切な権限を持つサービスアカウントの資格情報

設定

Google Cloud プロジェクトを作成し、Analytics Data API を有効にする
サービスアカウントを作成し、認証情報JSONファイルをダウンロードします
サービスアカウントに GA4 プロパティへの適切なアクセス権を付与します
環境変数を設定します。

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ファイルを参照してください。

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested