Google Analytics MCP

用于 Google Analytics 4 的本地 MCP 服务器。将 GA4 Data API 封装在专注于 SEO 和付费 报告的工具中。

工具

设置

git clone https://github.com/ZLeventer/google-analytics-mcp-server.git
cd google-analytics-mcp-server
npm install
npm run build

凭据

将 .env.example 复制为 .env 并填写：

• GA4_PROPERTY_ID — 来自 GA4 管理 → 媒体资源设置的数字媒体资源 ID（例如 123456789）。不是衡量 ID (G-XXXXXXX)。

• GOOGLE_APPLICATION_CREDENTIALS — 服务账号 JSON 密钥文件的绝对路径。

创建服务账号

1. 前往 console.cloud.google.com → 选择/创建一个项目

2. API 和服务 → 库 → 启用 Google Analytics Data API

3. IAM 和管理 → 服务账号 → 创建服务账号（命名为 ga4-mcp 或类似名称）

4. 在创建的账号上 → 密钥 → 添加密钥 → 创建新密钥 → JSON → 下载

5. 将 JSON 保存为该目录下的 service-account.json（已包含在 .gitignore 中）

6. 在 GA4 → 管理 → 媒体资源访问权限管理 中，点击 + → 粘贴服务账号电子邮件 (ga4-mcp@project-id.iam.gserviceaccount.com) → 分配 查看者 角色

Google SDK 会自动读取 GOOGLE_APPLICATION_CREDENTIALS — 无需更改代码。

安装到 Claude Code

claude mcp add google-analytics \
  --env-file "/absolute/path/to/google-analytics-mcp-server/.env" \
  -- node "/absolute/path/to/google-analytics-mcp-server/dist/index.js"

或者手动添加到 ~/.claude.json：

{
  "mcpServers": {
    "google-analytics": {
      "command": "node",
      "args": ["/absolute/path/to/google-analytics-mcp-server/dist/index.js"],
      "env": {
        "GA4_PROPERTY_ID": "123456789",
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/google-analytics-mcp-server/service-account.json"
      }
    }
  }
}

安装后重启 Claude Code。

日期格式

所有日期参数均接受 GA4 格式：

• YYYY-MM-DD（例如 2026-04-01）

• NdaysAgo（例如 28daysAgo, 90daysAgo）

• yesterday, today

默认值：28daysAgo → yesterday。

验证

配置好凭据后：

node -e '
  import("./dist/tools/reports.js").then(m =>
    m.channelPerformance({ start_date: "7daysAgo", end_date: "yesterday", limit: 10 })
  ).then(r => console.log(JSON.stringify(r, null, 2)))
'

如果返回了行数据，则说明一切正常。预期错误：

• GA4_PROPERTY_ID is not set — 检查 .env

• PERMISSION_DENIED — 服务账号未被授予该媒体资源的查看者权限

• 403 Google Analytics Data API has not been used — 在 GCP 项目中启用该 API

路线图

• [ ] 管理 API 工具（列出自定义维度、转化事件、受众群体），按需添加

• [ ] Search Console MCP 作为兄弟服务器，用于排名/展示次数/点击率数据（与此服务器互补）

• [ ] 与 Demandbase MCP 配对，将 GA4 流量与公司画像（账户级归因）结合