Servidor MCP de la API de datos de Google Analytics

Proporciona una interfaz para acceder a la API de datos de Google Analytics mediante un servidor de Protocolo de contexto de modelo (MCP).

función

Este servidor MCP proporciona las herramientas y los recursos para acceder a las funciones clave de la API de datos de Google Analytics:

herramienta

• get_report : recupera un informe basado en un rango de fechas, una métrica y una dimensión específicos

• get_realtime_data : Obtener datos en tiempo real

recurso

• ga4://property/{propertyId}/metadata : Accede a los metadatos de una propiedad de Google Analytics

Related MCP server: Policy Analyzer API MCP Server

configuración

Prerrequisitos

1. Cree un proyecto de Google Cloud y habilite la API de datos de Analytics.

2. Cree una cuenta de servicio y descargue el archivo JSON de credenciales

3. Otorgue a la cuenta de servicio el acceso adecuado a su propiedad GA4

Para obtener instrucciones de configuración detalladas, consulte la Guía de configuración .

instalar

# リポジトリをクローン
git clone https://github.com/eno-graph/mcp-server-google-analytics.git
cd mcp-server-google-analytics

# 依存関係をインストール
npm install

# ビルド
npm run build

Configuración de variables de entorno

Se deben configurar las siguientes variables de entorno:

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"

Cómo utilizar

Iniciando el servidor

npm start

Alternativamente, puede utilizar el script proporcionado:

./run-server.sh

Configuración de escritorio de Claude

Agregue lo siguiente a su archivo de configuración de Claude Desktop:

{
  "mcpServers": {
    "google-analytics": {
      "command": "node",
      "args": ["/path/to/mcp-server-google-analytics/build/index.js"],
      "env": {
        "GOOGLE_CLIENT_EMAIL": "your-service-account@project.iam.gserviceaccount.com",
        "GOOGLE_PRIVATE_KEY": "your-private-key",
        "GA_PROPERTY_ID": "your-ga4-property-id"
      }
    }
  }
}

Para obtener un ejemplo de configuración detallado, consulte claude-desktop-config-sample.json .

Ejemplos de uso de la herramienta

Obtenga el informe

get_report ツールを使用して、過去7日間のアクティブユーザー数とページビュー数を取得します。

引数:
{
  "startDate": "7daysAgo",
  "endDate": "today",
  "metrics": ["activeUsers", "screenPageViews"],
  "dimensions": ["date"],
  "limit": 10
}

Obtenga datos en tiempo real

get_realtime_data ツールを使用して、現在アクティブなユーザー数を取得します。

引数:
{
  "metrics": ["activeUsers"],
  "dimensions": ["deviceCategory"],
  "limit": 10
}

Ejemplos de uso de recursos

ga4://property/123456789/metadata リソースにアクセスして、利用可能なメトリクスとディメンションを確認します。

Ejemplo de uso

Para ver un ejemplo de uso con Claude, consulte Ejemplo de uso de Claude .

licencia

Instituto Tecnológico de Massachusetts (MIT)