Google Analytics 数据 API MCP 服务器
提供使用模型上下文协议 (MCP) 服务器访问 Google Analytics 数据 API 的接口。
功能
此 MCP 服务器提供了访问 Google Analytics 数据 API 主要功能的工具和资源：
工具
get_report ：根据指定的日期范围、指标和维度检索报告
get_realtime_data ：获取实时数据
资源
ga4://property/{propertyId}/metadata ：访问 Google Analytics（分析）媒体资源的元数据
Related MCP server: Policy Analyzer API MCP Server
设置
先决条件
创建 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"
如何使用
启动服务器
npm start
或者，您可以使用提供的脚本：
./run-server.sh
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 使用示例。
执照
麻省理工学院