AI导哈

GTM MCP服务器（自托管）

自托管的Google Tag Manager MCP服务器，通过标准Node.js stdio服务器与GCP服务账户认证，直接处理GTM API调用。

  • by KUHL-HQ
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 KUHL-HQ/gtm-mcp

使用说明

GTM MCP服务器（自托管）

Google标签管理器的自托管MCP服务器。分叉自 Stape的GTM MCP 并从Cloudflare Workers转换为具有GCP服务帐户身份验证的标准Node.js stdio服务器。

所有GTM API调用都直接到Google，没有第三方代理。

团队设置（在我们的服务器上）

生产生活在 /home/tay/projects/gtm-mcp/ 并在以下情况下自动部署 main 通过GitHub webhook同步推送。

团队成员

运行共享的MCP设置脚本，将GTM MCP添加到您的Claude Code配置中：

bash /srv/projects/mcps/setup.sh gtm-mcp-server

或手动添加到 ~/.claude/settings.json:

{
  "mcpServers": {
    "gtm-mcp-server": {
      "command": "node",
      "args": ["/home/tay/projects/gtm-mcp/dist/index.js"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/home/tay/projects/gtm-mcp/secrets/service-account.json"
      }
    }
  }
}

然后重新启动Claude Code或运行 /mcp 重新加载。

运作原理

MCP stdio服务器由Claude Code按需生成，每个会话都有自己的进程。没有持续运行的服务器。共享构建在 /home/tay/projects/gtm-mcp/dist/ 每个会话都从中启动，共享服务帐户密钥提供身份验证。

自动部署

推到 main 上 KUHL-HQ/gtm-mcp 触发GitHub webhook：

  1. 将最新代码拉到 /home/tay/projects/gtm-mcp/
  2. 跑 npm install && npm run build

新的Claude Code会话将自动使用更新的版本。

发展

致力于变革

  1. 在您的开发克隆中工作 /home/tay/dev/gtm-mcp/
  2. 创建要素分支
  3. 打开PR——CI必须通过(npx tsc --noEmit)需要1个批准
  4. 合并到 main --自动部署到生产环境

本地开发人员

cd /home/tay/dev/gtm-mcp
npm install
npm run build

# Test locally:
GOOGLE_APPLICATION_CREDENTIALS=./secrets/service-account.json node dist/index.js

GCP服务帐户设置

  1. 首选 GCP控制台>IAM>服务帐户
  2. 创建服务帐户--不需要特殊的GCP IAM角色
  3. 启用 标签管理器API 关于该项目
  4. 创建JSON密钥并将其下载到 secrets/service-account.json
  5. 在GTM中，以用户身份添加服务帐户电子邮件 发布 权限（帐户级别）

Docker（替代方案）

npm run build
docker compose up --build

通过以下方式安装服务帐户密钥 docker-compose.yml.

工具

18个MCP工具，涵盖完整的GTM API v2：

工具 操作
gtm_account 获取、列出、更新
gtm_container 创建、获取、列出、更新、删除、组合、查找、moveTagId、代码段
gtm_workspace 创建、获取、列出、更新、删除、同步、获取状态、创建版本、快速预览
gtm_tag 创建、获取、列出、更新、删除、还原
gtm_trigger 创建、获取、列出、更新、删除、还原
gtm_variable 创建、获取、列出、更新、删除、还原
gtm_built_in_variable 创建、列出、删除、还原
gtm_folder 创建、获取、列出、更新、删除、将实体移动到文件夹、还原
gtm_template 创建、获取、列出、更新、删除、还原
gtm_client 创建、获取、列出、更新、删除、还原
gtm_transformation 创建、获取、列出、更新、删除、还原
gtm_environment 创建、获取、列出、更新、删除、重新授权
gtm_version 获取、实时、发布、删除、设置最新、取消删除、更新
gtm_version_header 列表，最新
gtm_zone 创建、获取、列出、更新、删除、还原
gtm_user_permission 创建、获取、列出、更新、删除
gtm_destination 获取、列表、链接
gtm_gtag_config 创建、获取、列出、更新、删除

许可证

Apache-2.0（从 stape-io/google标签管理器mcp服务器)

相关 MCP