remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides access to Google Analytics 4 (GA4) data, allowing retrieval of page view metrics, active and new user tracking, event analysis, and user behavior metrics (session duration, bounce rate) with customizable dimensions and date ranges.

Google Analytics MCP 服务器

用于访问 Google Analytics 4 (GA4) 数据的 MCP 服务器实现，使用模型上下文协议 TypeScript SDK 构建。

特征

获取具有可自定义维度的页面浏览量指标
跟踪一段时间内的活跃用户和新用户
分析特定事件及其指标
监控用户行为指标（会话时长、跳出率）
所有查询均可灵活选择日期范围

先决条件

Node.js 20 或更高版本
Google Analytics 4 媒体资源
已启用 Analytics Data API 的 Google Cloud 项目
具有适当权限的服务帐户凭据

设置

创建 Google Cloud 项目并启用 Analytics Data API
创建服务帐户并下载凭证 JSON 文件
授予服务帐号对您的 GA4 资源的适当访问权限
设置环境变量：

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"

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Google Analytics Server：

npx -y @smithery/cli install mcp-server-google-analytics --client claude

手动安装

pnpm install mcp-server-google-analytics

用法

启动服务器

pnpm start

Claude Desktop中的配置

将其添加到您的 Claude Desktop 配置中：

{
  "mcpServers": {
    "google-analytics": {
      "command": "npx",
      "args": ["-y", "mcp-server-google-analytics"],
      "env": {
        "GOOGLE_CLIENT_EMAIL": "your-service-account@project.iam.gserviceaccount.com",
        "GOOGLE_PRIVATE_KEY": "your-private-key",
        "GA_PROPERTY_ID": "your-ga4-property-id"
      }
    }
  }
}

可用函数

获取页面浏览量

获取特定日期范围内的页面浏览量指标：

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": ["page", "country"] // Optional
}

获取活跃用户

获取活跃用户指标：

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31"
}

获取事件

获取事件指标：

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "eventName": "purchase" // Optional
}

获取用户行为

获取用户行为指标：

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31"
}

安全注意事项

始终对敏感凭据使用环境变量
实施适当的 CORS 设置
设置服务帐户权限时遵循最小特权原则
定期轮换服务帐户凭据
监控 API 使用情况并根据需要实施速率限制

贡献

欢迎贡献代码！请阅读我们的贡献指南，详细了解我们的行为准则以及提交 Pull Request 的流程。

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested