快速入门

前置条件

1. 创建 Google Cloud 项目并启用 Analytics Data API。
2. 创建服务账号并下载 JSON 格式的认证信息。
3. 确保服务账号具备 GA4 属性的访问权限。

安装与运行

1. 克隆代码仓库： git clone https://github.com/eno-graph/mcp-server-google-analytics.git cd mcp-server-google-analytics
2. 安装依赖： npm install
3. 构建项目： npm run build
4. 设置环境变量： export GOOGLE_CLIENT_EMAIL="your-service-account@project.iam.gserviceaccount.com" export GOOGLE_PRIVATE_KEY="your-private-key" export GA_PROPERTY_ID="your-ga4-property-id"
5. 启动服务器： npm start

工具使用示例

• 获取过去7天的报告： 使用 get_report 工具，指定参数如 startDate、endDate、metrics 和 dimensions。
• 获取实时数据： 使用 get_realtime_data 工具，指定 metrics 和 dimensions 参数。

更多信息参考 Claude 使用指南。