ga4-mcp-server

概述

这是一个生产就绪的 MCP 服务器，通过模型上下文协议 (MCP) 和 REST 端点访问 Google Analytics 4 数据。服务器提供五个有用工具：获取 URL 分析、参与度、流量来源、转化和页面浏览量。使用服务账户进行身份验证，响应格式结构化并包含基于时间的细分，具有全面的错误处理功能。使用 TypeScript 和官方 @modelcontextprotocol/sdk 构建，展示了最佳实践，包括 Jest 测试、调试日志以及针对 MCP 和 REST 接口的测试脚本。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• getUrlAnalytics({ url: string, timeframe?: string, startDate?: string, endDate?: string, trafficSourceLimit?: number }) => AnalyticsResponse

  Get comprehensive analytics for a URL including engagement, traffic sources, and conversions

  试试:Show me analytics for the /about page for this month试试:What are the traffic sources for our homepage?试试:Get analytics for /products from January 1 to January 31
• getUrlEngagement({ url: string, timeframe?: string, startDate?: string, endDate?: string }) => AnalyticsResponse

  Get engagement metrics for a URL such as average session duration and bounce rate

  试试:What's the engagement rate for our blog posts?试试:Show me bounce rate for the /contact page试试:Get engagement metrics for the /pricing page from last week
• getUrlSourceTraffic({ url: string, timeframe?: string, startDate?: string, endDate?: string, limit?: number }) => AnalyticsResponse

  Get traffic source data for a URL showing how users are finding the page

  试试:Where is our traffic coming from for the /sign-up page?试试:Show me the top 5 traffic sources for our homepage试试:What are the main traffic sources for /blog posts?
• getUrlConversions({ url: string, timeframe?: string, startDate?: string, endDate?: string }) => AnalyticsResponse

  Get conversion events and metrics for a URL

  试试:Show me conversion data for our checkout page试试:What conversion events happened on /subscribe?试试:Get conversion metrics for the /pricing page
• getUrlPageViews({ url: string, timeframe?: string, startDate?: string, endDate?: string }) => AnalyticsResponse

  Get page view statistics for a URL

  试试:How many page views did the /about page get last week?试试:Show me page view trends for our blog试试:Compare page views for /products and /services

可对比工具

安装

pnpm install

GA_PROPERTY_ID=您的 GA4 属性 ID
GOOGLE_APPLICATION_CREDENTIALS=您的服务账户凭据文件路径
PORT=3001 # 可选，默认为 3001

pnpm dev

{
  "mcpServers": {
    "ga4": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {
        "GA_PROPERTY_ID": "您的 GA4 属性 ID",
        "GOOGLE_APPLICATION_CREDENTIALS": "您的服务账户凭据文件路径"
      }
    }
  }
}

FAQ

此服务器需要什么身份验证方法？

服务器需要 Google 服务账户身份验证。您需要提供服务账户 JSON 文件并设置 GOOGLE_APPLICATION_CREDENTIALS 环境变量。

我可以将此服务器与我现有的 Google Analytics 4 属性一起使用吗？

可以，只要您的服务账户具有访问 GA4 属性数据的适当权限即可。您需要在 Google Cloud Console 中进行配置。

ga4-mcp-server 对比