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 プロジェクト
適切な権限を持つサービスアカウントの資格情報

設定

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

Install Server

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

Need Help?

Report Issue

Related Servers

mcp-server-google-analytics