Google Analytics 数据 API MCP 服务器
提供使用模型上下文协议 (MCP) 服务器访问 Google Analytics 数据 API 的接口。
功能
此 MCP 服务器提供了访问 Google Analytics 数据 API 主要功能的工具和资源:
工具
- get_report :根据指定的日期范围、指标和维度检索报告
- get_realtime_data :获取实时数据
资源
- ga4://property/{propertyId}/metadata :访问 Google Analytics(分析)媒体资源的元数据
设置
先决条件
- 创建 Google Cloud 项目并启用 Analytics Data API。
- 创建服务帐户并下载凭证 JSON 文件
- 授予服务帐号对您的 GA4 媒体资源的适当访问权限
有关详细的设置说明,请参阅设置指南。
安装
# リポジトリをクローン
git clone https://github.com/eno-graph/mcp-server-google-analytics.git
cd mcp-server-google-analytics
# 依存関係をインストール
npm install
# ビルド
npm run build
设置环境变量
必须设置以下环境变量:
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"
如何使用
启动服务器
或者,您可以使用提供的脚本:
Claude 桌面设置
将以下内容添加到您的 Claude Desktop 配置文件:
{
"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 。
使用该工具的示例
获取报告
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 使用示例。
执照
麻省理工学院