README.md•3.44 kB
# Google Analytics Data API MCP Server
Model Context Protocol (MCP) サーバーを使用して、Google Analytics Data APIにアクセスするためのインターフェースを提供します。
## 機能
このMCPサーバーは、Google Analytics Data APIの主要な機能にアクセスするためのツールとリソースを提供します：
### ツール
- **get_report**: 指定した日付範囲、メトリクス、ディメンションに基づいてレポートを取得します
- **get_realtime_data**: リアルタイムデータを取得します
### リソース
- **ga4://property/{propertyId}/metadata**: Google Analyticsプロパティのメタデータにアクセスします
## セットアップ
### 前提条件
1. Google Cloudプロジェクトを作成し、Analytics Data APIを有効にします
2. サービスアカウントを作成し、認証情報JSONファイルをダウンロードします
3. サービスアカウントにGA4プロパティへの適切なアクセス権を付与します
詳細なセットアップ手順については、[セットアップガイド](docs/setup-guide.md)を参照してください。
### インストール
```bash
# リポジトリをクローン
git clone https://github.com/eno-graph/mcp-server-google-analytics.git
cd mcp-server-google-analytics
# 依存関係をインストール
npm install
# ビルド
npm run build
```
### 環境変数の設定
以下の環境変数を設定する必要があります：
```bash
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"
```
## 使用方法
### サーバーの起動
```bash
npm start
```
または、提供されているスクリプトを使用することもできます：
```bash
./run-server.sh
```
### Claude Desktopでの設定
Claude Desktopの設定ファイルに以下を追加します：
```json
{
"mcpServers": {
"google-analytics": {
"command": "node",
"args": ["/path/to/mcp-server-google-analytics/build/index.js"],
"env": {
"GOOGLE_CLIENT_EMAIL": "your-service-account@project.iam.gserviceaccount.com",
"GOOGLE_PRIVATE_KEY": "your-private-key",
"GA_PROPERTY_ID": "your-ga4-property-id"
}
}
}
}
```
詳細な設定例については、[claude-desktop-config-sample.json](claude-desktop-config-sample.json)を参照してください。
## ツールの使用例
### レポートの取得
```
get_report ツールを使用して、過去7日間のアクティブユーザー数とページビュー数を取得します。
引数:
{
"startDate": "7daysAgo",
"endDate": "today",
"metrics": ["activeUsers", "screenPageViews"],
"dimensions": ["date"],
"limit": 10
}
```
### リアルタイムデータの取得
```
get_realtime_data ツールを使用して、現在アクティブなユーザー数を取得します。
引数:
{
"metrics": ["activeUsers"],
"dimensions": ["deviceCategory"],
"limit": 10
}
```
## リソースの使用例
```
ga4://property/123456789/metadata リソースにアクセスして、利用可能なメトリクスとディメンションを確認します。
```
## 使用例
Claudeでの使用例については、[Claude使用例](examples/claude-usage-examples.md)を参照してください。
## ライセンス
MIT