标签管理服务器

一个开源的MCP服务器,为AI代理提供完整的Google Tag Manager API v2访问能力,支持本地运行,无需外部服务。

  • by CarC96
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 CarC96/google-tag-manager-mcp

使用说明

谷歌标签管理器MCP服务器

建造于 Growthers.io --数据驱动型增长机构。

开源MCP(模型上下文协议)服务器,为人工智能代理提供对Google Tag Manager API v2的完全访问。

适用于Claude Code、Claude Desktop、Cursor和任何兼容MCP的客户端。管理帐户、容器、工作区、标签、触发器、变量、同意模式和容器版本——所有这些都可以通过您的AI助手完成。

不需要外部服务。使用您自己的Google凭据在您的计算机上本地运行。

先决条件

设置

1.启用标签管理器API

  1. 首选 谷歌云控制台
  2. 选择或创建项目
  3. 首选 API和服务>启用API
  4. 搜索 标签管理器API 并启用它

2.身份验证

gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/tagmanager.readonly,https://www.googleapis.com/auth/tagmanager.edit.containers,https://www.googleapis.com/auth/tagmanager.edit.containerversions"

这将在以下位置创建凭据文件 ~/.config/gcloud/application_default_credentials.json.

提示: 如果默认的gcloud客户端阻止了某些作用域,请在您的Google Cloud项目中创建一个自定义OAuth客户端ID(API和服务>凭据>创建OAuth客户端>桌面应用程序),然后使用 --client-id-file=<path-to-client-secret.json> 使用上面的命令。

3.安装

选项A:带pipx(推荐)

pipx install git+https://github.com/CarC96/google-tag-manager-mcp.git

选项B:来源

git clone https://github.com/CarC96/google-tag-manager-mcp.git
cd google-tag-manager-mcp
pip install .

4.配置您的MCP客户端

添加到MCP客户端配置中(例如。 ~/.claude.json 克劳德代码):

{
  "mcpServers": {
    "gtm-mcp": {
      "type": "stdio",
      "command": "pipx",
      "args": ["run", "gtm-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "<path-to>/application_default_credentials.json"
      }
    }
  }
}

替换 <path-to> 带有凭据文件的实际路径(通常 ~/.config/gcloud/application_default_credentials.json).

运作原理

尽管名称为“服务器”,但它作为一个 本地进程 在你的机器上。您的MCP客户端将其作为子进程启动,并通过stdin/stdout进行通信。没有打开网络端口,也不需要云托管——它本质上是一个插件。

MCP Client (Claude Code, etc.)  ←— stdin/stdout —→  gtm-mcp (local process)  ——→  Google Tag Manager API

可用工具(30)

账户

工具 说明
list_accounts 列出所有GTM帐户
get_account 获取帐户详细信息
list_user_permissions 列出帐户的权限

容器

工具 说明
list_containers 列出帐户中的所有容器
get_container 获取容器详细信息
get_container_snippet 获取网站的安装代码片段

工作区

工具 说明
list_workspaces 列出容器中的工作区
get_workspace 获取工作区详细信息
get_workspace_status 检查冲突和修改的实体
create_workspace 创建新工作区

标签

工具 说明
list_tags 列出所有标签
get_tag 获取标签详细信息
create_tag 创建新标签
update_tag 更新标签
delete_tag 删除标签

触发器

工具 说明
list_triggers 列出所有触发器
get_trigger 获取触发器详细信息
create_trigger 创建新触发器
update_trigger 更新触发器
delete_trigger 删除触发器

变量

工具 说明
list_variables 列出所有变量
get_variable 获取变量详细信息
create_variable 创建新变量
update_variable 更新变量
delete_variable 删除变量

内置变量

工具 说明
list_built_in_variables 列出所有已启用的内置变量

版本

工具 说明
list_version_headers 列出所有版本头(摘要)
get_live_version 获取所有实体的已发布版本(非常适合审计)
get_version 按ID获取特定版本

用例

  • 同意模式审核 --在几秒钟内分析所有标签及其同意设置
  • 批量标签管理 --以编程方式创建、更新或删除标签/触发器/变量
  • GDPR合规性 --验证所有标签的同意配置
  • 容器迁移 --跨容器读取和复制配置
  • 文档 --自动生成GTM设置报告

关于Growthers.io

Growthers.io 是一家数据驱动的增长机构,专门从事分析、跟踪基础设施和营销自动化。我们构建的工具使数字营销更加高效和合规。

许可证

阿帕奇-2.0