mcp-ga4
用于Google Analytics 4的MCP服务器——通过Claude运行报告、实时数据、自定义维度和属性管理。
特性
- 9个工具，涵盖报告、实时数据、自定义维度/指标、数据流和反馈
- 两种配置模式：单属性（env-vars）和多客户端（config.json）
- 同时支持服务帐户和OAuth凭据
- 相对日期支持（今天、昨天、7天前、30天前、90天前）
- 基于具有弹性模式的官方Google SDK构建
安装
npm install mcp-ga4或者克隆存储库：
git clone https://github.com/mharnett/mcp-ga4.git
cd mcp-ga4
npm install
npm run build配置
安全： 永远不要分享你的 .mcp.json 文件或将其提交到git——它可能包含API凭据。添加 .mcp.json 到你的 .gitignore.
模式1：单一属性（环境变量）
设置环境变量以连接到单个GA4属性：
GA4_PROPERTY_ID=123456789
GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json模式2：多客户端（config.json）
创建一个 config.json 在项目根目录中，将多个GA4属性映射到项目目录。服务器根据调用者的工作目录自动检测要使用的属性。
{
"credentials_file": "/path/to/oauth-credentials.json",
"clients": {
"client-a": {
"name": "Client A",
"folder": "/path/to/client-a/project",
"property_id": "123456789"
},
"client-b": {
"name": "Client B",
"folder": "/path/to/client-b/project",
"property_id": "987654321"
}
}
}用法
克劳德代码（.mcp.json）
单属性模式：
{
"mcpServers": {
"ga4": {
"command": "npx",
"args": ["mcp-ga4"],
"env": {
"GA4_PROPERTY_ID": "123456789",
"GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
}
}
}
}多客户端模式：
{
"mcpServers": {
"ga4": {
"command": "node",
"args": ["/path/to/mcp-ga4/dist/index.js"]
}
}
}克劳德桌面： 添加 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）。
常见查询模式
首页： 尺寸=pagePath，指标=screenPageViews，order_by=screenPageViews
交通来源： 尺寸=sessionSource,sessionMedium，指标=sessions,totalUsers
每日趋势： 尺寸=date，指标=sessions,totalUsers
活动绩效： 尺寸=sessionCampaignName，指标=sessions,conversions
设备故障： 尺寸=deviceCategory，指标=sessions,totalUsers
工具
| 工具 | 说明 |
|---|---|
ga4_get_client_context | 返回活动GA4属性ID和客户端名称 |
ga4_run_report | 运行一个包含维度、指标、日期范围和过滤器的标准GA4报告 |
ga4_realtime_report | 查询实时数据（过去30分钟） |
ga4_list_custom_dimensions | 列出该属性的所有自定义尺寸 |
ga4_create_custom_dimension | 创建新的自定义维度 |
ga4_list_custom_metrics | 列出该属性的所有自定义指标 |
ga4_list_data_streams | 列出网络/应用程序数据流及其测量ID |
ga4_send_feedback | 提交对查询结果的反馈 |
ga4_suggest_improvement | 建议新的查询模式或改进 |
日期格式
使用 YYYY-MM-DD 对于绝对日期，或这些相对快捷方式：
todayyesterday7daysAgo30daysAgo90daysAgo
通用尺寸和度量
尺寸： date、dateHour、eventName、pagePath、pageTitle、sessionSource、sessionMedium、sessionCampaignName、国家、城市、设备类别、浏览器、操作系统、landingPage、pageReferrer、newVsReturning、firstUserSource、firstUserMedium、firstUserCampaignName
韵律学： session、totalUsers、newUsers、activeUsers、screenPageViews、eventCount、转化率、engagedSessions、engagementRate、averageSessionDuration、bounceRate、sessions PerUser、screenPageViews PerSession、userEngagementDuration
数据新鲜度
- 标准报告：24-48小时延迟
- 实时报告：仅过去30分钟
建筑
构建于：
@google-analytics/data--用于报告的GA4数据API@google-analytics/admin--用于物业管理的GA4管理员APIcockatiel--弹性（重试、断路器）pino--结构化测井
许可证
麻省理工学院
作者
由Mark Harnett建造/ 德雷克营销