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

configuración

Prerrequisitos

Cree un proyecto de Google Cloud y habilite la API de datos de Analytics.
Cree una cuenta de servicio y descargue el archivo JSON de credenciales
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)

This server cannot be installed

security - not tested

license - not found

quality - not tested

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.

Proporciona una interfaz para acceder a la API de datos de Google Analytics a través del Protocolo de contexto de modelo (MCP), lo que permite a los usuarios recuperar informes y datos en tiempo real de las propiedades de Google Analytics 4.

Related MCP Servers

mcp-server-google-analytics
ruchernchong
-
security
A
license
-
quality
An MCP server implementation for accessing Google Analytics 4 (GA4) data, built using the Model Context Protocol TypeScript SDK.
Last updated -
22
TypeScript
MIT License
mcp-google
Ejb503
-
security
F
license
-
quality
A specialized Model Context Protocol (MCP) server that integrates Google services (Gmail, Calendar, etc.) into your AI workflows. This server enables seamless access to Google services through MCP, allowing AI agents to interact with Gmail, Google Calendar, and other Google services.
Last updated -
10
3
TypeScript
AlphaVantage-MCP
berlinbra
A
security
A
license
A
quality
A Model Context Protocol (MCP) server that provides real-time access to financial market data through the free Alpha Vantage API. This server implements a standardized interface for retrieving stock quotes and company information.
Last updated -
5
30
Python
MIT License
PowerPlatform MCP
michsob
-
security
A
license
-
quality
A Model Context Protocol (MCP) server that provides intelligent access to PowerPlatform/Dataverse entities and records. This tool offers context-aware assistance, entity exploration and metadata access.
Last updated -
466
1
JavaScript
MIT License

View all related MCP servers

Google Analytics Data API MCP Server