mcp-gtm-ga4
用于Google Tag Manager和GA4的MCP服务器——通过Claude进行标签管理、同意审核、工作区版本控制和分析报告。
特性
- 14工具 涵盖GTM工作空间管理（标签、触发器、变量）、同意合规性审计、工作空间预览/版本控制和GA4报告
- 沙箱安全 --所有写入操作都验证它们针对的是已解析的工作区，拒绝写入非沙盒工作区
- 多客户端支持 --通过环境变量为每个客户端进行配置
- 自动检测默认工作区ID --除非使用自定义沙盒，否则不需要手动指定工作区ID
安装
npm install mcp-gtm-ga4或者克隆并构建：
git clone https://github.com/mharnett/mcp-gtm-ga4.git
cd mcp-gtm-ga4
npm install
npm run build配置
安全： 永远不要分享你的 .mcp.json 文件或将其提交到git——它可能包含API凭据。添加 .mcp.json 给你的 .gitignore.
所有配置都是通过环境变量进行的。不 config.json 文件是必需的。
| 变量 | 必填 | 描述 |
|---|---|---|
GOOGLE_APPLICATION_CREDENTIALS | 是 | GCP服务帐户JSON密钥文件的路径 |
GTM_ACCOUNT_ID | 是 | GTM帐户ID |
GTM_CONTAINER_ID | 是 | GTM容器ID |
GA4_PROPERTY_ID | 是 | GA4属性ID |
GTM_SANDBOX_WORKSPACE_ID | 否 | 覆盖工作区ID（如果省略，则自动检测默认工作区） |
MCP_SERVER_NAME | 否 | 服务器名称（默认为包名称 mcp-gtm-ga4) |
看 config.example.json 作为参考模板。
用法
克劳德代码（.mcp.json）
{
"mcpServers": {
"gtm-ga4": {
"command": "node",
"args": ["/path/to/mcp-gtm-ga4/dist/index.js"],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account.json",
"GTM_ACCOUNT_ID": "1234567890",
"GTM_CONTAINER_ID": "9876543",
"GA4_PROPERTY_ID": "331956119"
}
}
}
}新巴拿马型船舶
GTM_ACCOUNT_ID=1234567890 \
GTM_CONTAINER_ID=9876543 \
GA4_PROPERTY_ID=331956119 \
GOOGLE_APPLICATION_CREDENTIALS=/path/to/sa.json \
npx mcp-gtm-ga4克劳德桌面： 添加 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）。
安全
工作区沙盒保护
所有写入操作(gtm_update_tag, gtm_create_tag, gtm_preview, gtm_create_version)在执行之前，验证它们是否以解析的工作区为目标。如果请求试图写入其他工作区，服务器将返回 SafetyError 并阻止操作。
这可以防止在针对沙盒工作区配置MCP服务器时发生意外的生产更改。
工具
GTM标签
| 工具 | 说明 |
|---|---|
gtm_list_tags | 列出工作区中所有具有同意状态和触发条件的标签 |
gtm_get_tag | 通过标签ID获取完整的标签配置 |
gtm_update_tag | 更新现有标签（通过JSON合并补丁） |
gtm_create_tag | 从JSON定义创建新标记 |
GTM结构
| 工具 | 说明 |
|---|---|
gtm_list_triggers | 列出所有触发器（ID、名称、类型） |
gtm_list_variables | 列出所有变量（ID、名称、类型） |
GTM同意书
| 工具 | 说明 |
|---|---|
gtm_audit_consent | 审核所有标签的同意配置合规性 |
GTM工作区
| 工具 | 说明 |
|---|---|
gtm_preview | 生成当前工作区的快速预览 |
gtm_create_version | 从工作区创建新的容器版本 |
GA4报告
| 工具 | 说明 |
|---|---|
gtm_ga4_run_report | 运行包含维度、指标、日期范围和过滤器的GA4报告 |
gtm_ga4_realtime_report | 运行GA4实时报告（最后30分钟） |
GA4管理员
| 工具 | 说明 |
|---|---|
gtm_ga4_list_custom_dimensions | 列出该属性的所有自定义尺寸 |
gtm_ga4_create_custom_dimension | 创建新的自定义维度 |
建筑
- API GTM:
googleapis（标签管理器v2） - GA4数据:
@google-analytics/data（贝塔分析数据客户端） - GA4管理员:
@google-analytics/admin（分析管理服务客户端） - 韧性:
cockatiel（重试、断路器、超时策略） - 日志记录:
pino和pino-pretty - 运输：MCP SDK标准传输
许可证
麻省理工学院
作者
由Mark Harnett建造/ 德雷克营销