Servidor MCP de Google Analytics

Una implementació de servidor MCP per accedir a dades de Google Analytics 4 (GA4), construïda amb el SDK TypeScript del Model Context Protocol.

Característiques

• Obtenir mètriques de visualitzacions de pàgina amb dimensions personalitzables
• Rastrejar usuaris actius i nous al llarg del temps
• Analitzar esdeveniments específics i les seves mètriques
• Monitoritzar mètriques de comportament d'usuari (durada de sessió, taxa de rebote)
• Selecció flexible de rang de dates per a totes les consultes

Requisits previos

• Node.js 20 o superior
• Propietat Google Analytics 4
• Projecte Google Cloud amb l'API de Dades d'Analytics habilitada
• Credencials de compte de servei amb permisos adequats

Configuració

• Createu un projecte Google Cloud i habiliteu l'API de Dades d'Analytics
• Createu un compte de servei i descarregueu el fitxer JSON de credencials
• Concediu al compte de servei l'accés adequat a la vostra propietat GA4
• Configureu les variables d'entorn:

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"

Instal·lació

Instal·lació via Smithery

Per instal·lar el Servidor de Google Analytics per a Claude Desktop automàticament via Smithery:

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

Instal·lació manual

pnpm install mcp-server-google-analytics

Ús

Inici del servidor

pnpm start

Configuració a Claude Desktop

Afegeix això a la teva configuració de 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"
      }
    }
  }
}

Funcions disponibles

getPageViews

Obtenir mètriques de visualitzacions de pàgina per a un rang de dates específic:

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

getActiveUsers

Obtenir mètriques d'usuaris actius:

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

getEvents

Obtenir mètriques d'esdeveniments:

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

getUserBehavior

Obtenir mètriques de comportament d'usuari:

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

Consideracions de seguretat

• Utilitzeu sempre variables d'entorn per a credencials sensibles
• Implanteu configuracions CORS adequades
• Seguiu el principi del menor privilegi quan configureu permisos del compte de servei
• Rotateu regularment les credencials del compte de servei
• Monitoritzeu l'ús de l'API i implementeu limitació de velocitat si cal

Contribució

Les contribucions són benvingudes! Llegiu la nostra Guia de Contribució per a detalls sobre el codi de conducta i el procés de presentació de pull requests.

Llicència

Aquest projecte està llicenciat sota la Llicència MIT - consulteu el fitxer LICENSE per a detalls.