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
使用法
サーバーの起動
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ファイルを参照してください。