Ganalytics MCP Server

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

このサーバーは、ツールとサービスを通じて、グーグルアナリティクスのデータにアクセスできるモデルコンテキストプロトコル（MCP）サーバーです。

2024年3月26日のテスト結果：

• 総アクティブユーザー数：102,883
• ベラルーシのアクティブユーザー数：64,837（63%）
• 総ページビュー数：2,422,925
• ベラルーシのページビュー数：1,950,160（80%）

✨ 主な機能

• MCP リソースを通じて、グーグルアナリティクスの指標と次元にアクセスできます。
• 柔軟なフィルタオプションを使用して、分析データを取得できます。
• フォーマットされたデータを取得し、洞察と提案を添付できます。
• TypeScript で実装され、強い型付けがあります。

📦 インストール

1. リポジトリをクローンします。
2. 依存関係をインストールします。

   npm install
   

3. .env.example を基に .env ファイルを作成し、グーグルアナリティクスの認証情報を追加します。
4. プロジェクトをビルドします。

   npm run build
   

グーグルアナリティクスの認証情報の設定

1. Google Cloud Console にアクセスします。
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
3. Google Analytics Data API を有効にします。
4. 適切な権限を持つサービスアカウントを作成します。
5. サービスアカウントのキー（JSON 形式）をダウンロードします。
6. JSON ファイルからクライアントのメールアドレスと秘密鍵を抽出します。
7. これらの情報を .env ファイルに追加します。

   GA_PROPERTY_ID=your_property_id
   GA_CLIENT_EMAIL=your-service-account@your-project.iam.gserviceaccount.com
   GA_PRIVATE_KEY=-----BEGIN PRIVATE KEY-----\nYourPrivateKeyHere\n-----END PRIVATE KEY-----
   

💻 使用例

基本的な使用法

サーバーの起動

node build/index.js

MCP の設定

cline_mcp_settings.json ファイルにサーバーを追加します。

{
  "mcpServers": {
    "google-analytics": {
      "command": "node",
      "args": ["/path/to/GAnalytics-MCP-server/build/index.js"],
      "env": {
        "GA_PROPERTY_ID": "your_property_id",
        "GA_CLIENT_EMAIL": "your-service-account@your-project.iam.gserviceaccount.com",
        "GA_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\\nYourPrivateKeyHere\\n-----END PRIVATE KEY-----"
      }
    }
  }
}

高度な使用法

get_analytics_data の使用

get_analytics_data を使用して、オプションのフィルターと分析を伴うグーグルアナリティクスのデータを取得できます。

{
  "metrics": ["activeUsers", "newUsers"],
  "dimensions": ["country", "deviceCategory"],
  "startDate": "2024-03-26",
  "endDate": "2024-03-26",
  "filters": {
    "dimensionFilter": {
      "dimension": "country",
      "value": "US"
    }
  },
  "orderBy": ["activeUsers desc"],
  "limit": 10,
  "offset": 0
}

利用可能なリソース

指標

• activeUsers：アクティブユーザー数
• newUsers：新規ユーザー数
• pageviews：ページビュー数
• sessions：セッション数
• bounceRate：離脱率

次元

• country：国/地域
• deviceCategory：デバイスカテゴリ
• platform：プラットフォーム
• mobileDeviceModel：モバイルデバイスのモデル
• os：オペレーティングシステム

開発とテスト

テストを実行するには、以下のコマンドを実行します。

npm test

📄 ライセンス

[ここにライセンス情報を追加]

貢献者

[ここに貢献者をリストアップ]