MCP Server Google Analytics

🚀 グーグルアナリティクス MCP サーバー

このサーバーは、モデルコンテキストプロトコル（Model Context Protocol）に基づく TypeScript SDK で実装された MCP サーバーで、Google Analytics 4 (GA4) のデータにアクセスするために使用されます。

✨ 主な機能

• カスタマイズ可能なディメンションを持つページビュー指標を取得する
• 特定の期間内のアクティブユーザーと新規ユーザーを追跡する
• 特定のイベントとその指標を分析する
• ユーザー行動指標（セッション時間、離脱率）を監視する
• すべてのクエリに対して柔軟な時間範囲の選択をサポートする

📦 インストール

前提条件

• Node.js 20 以上
• Google Analytics 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 を通じて Google Analytics サーバーを自動インストールします：

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"
      }
    }
  }
}

利用可能な機能

getPageViews

特定の期間内のページビュー指標を取得します：

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": ["page", "country"] // オプションのパラメーター
}

getActiveUsers

アクティブユーザーの指標を取得します：

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

getEvents

イベント指標を取得します：

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "eventName": "purchase" // オプションのパラメーター
}

getUserBehavior

ユーザー行動指標を取得します：

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

セキュリティに関する注意事項

• 常に環境変数を使用して機密認証情報を保存する
• 適切な CORS 設定を実装する
• サービスアカウントの権限を最小限の権限原則に従って設定する
• 定期的にサービスアカウントの認証情報を更新する
• API の使用状況を監視し、必要に応じてレート制限を実装する

コントリビューションガイド

コントリビューションを歓迎します！ 詳細は コントリビューションガイド をご覧ください。

関連ファイル

• LICENSE
• README.md
• CONTRIBUTING.md