Mixpanel MCP Server

Integra la analítica de Mixpanel en tus flujos de trabajo de IA.

GitHub
5
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Mixpanel

Un servidor de Protocolo de Contexto Modelo (MCP) para integrar análisis de Mixpanel en flujos de trabajo de IA. Este servidor permite que asistentes de IA como Claude rastreen eventos, vistas de página, registros de usuarios y actualicen perfiles de usuario en Mixpanel.

Nota de la Versión 2.0.1: Los nombres de las herramientas ahora incluyen el prefijo mixpanel_ para prevenir colisiones de nombres con otros servidores MCP de análisis.

Tabla de Contenidos

Características

  • Rastrear eventos personalizados en Mixpanel
  • Rastrear vistas de página con información de referencia
  • Rastrear registros de usuarios y crear perfiles de usuario
  • Actualizar perfiles de usuario existentes
  • Integración sencilla con Claude Desktop y otros clientes MCP

Instalación

Requisitos Previos

  • Node.js 16 o superior
  • Un token de proyecto de Mixpanel (obtén uno registrándote en Mixpanel)

Instalación con NPM (Recomendada)

# Install globally
npm install -g mixpanel-mcp-server

# Or use directly with npx
npx mixpanel-mcp-server --token YOUR_MIXPANEL_TOKEN

Instalación Manual

# Clone the repository
git clone https://github.com/yourusername/mixpanel-mcp-server.git
cd mixpanel-mcp-server

# Install dependencies
npm install

# Run the server
node index.js --token YOUR_MIXPANEL_TOKEN

Inicio Rápido

Para comenzar a usar el servidor MCP de Mixpanel con Claude Desktop:

  1. Asegúrate de que Claude Desktop esté instalado en tu máquina (descárgalo de claude.ai/download)

  2. Crea o edita el archivo de configuración de Claude Desktop:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %AppData%\Claude\claude_desktop_config.json

  3. Agrega la configuración del servidor MCP de Mixpanel:

{
  "mcpServers": {
    "mixpanel-analytics": {
      "command": "npx",
      "args": [
        "-y",
        "mixpanel-mcp-server",
        "--token",
        "YOUR_MIXPANEL_TOKEN"
      ]
    }
  }
}
  1. Reinicia Claude Desktop y ¡comienza a rastrear análisis!

Uso Detallado

Con Claude Desktop

Después de configurar el archivo de configuración como se muestra en la sección de Inicio Rápido, puedes usar las capacidades de análisis de Mixpanel directamente en tus conversaciones con Claude.

Ejemplos de indicaciones que puedes usar:

  • "Rastrea un evento personalizado en Mixpanel llamado 'document_generated' para el usuario 'user123'"
  • "Rastrea una vista de página para la página de inicio en Mixpanel"
  • "Crea un nuevo perfil de usuario en Mixpanel para John Doe con el correo john@example.com"
  • "Actualiza la información del perfil de usuario en Mixpanel para el usuario 'user123'"

Claude usará la herramienta MCP de Mixpanel apropiada según tu solicitud.

Con Otros Clientes MCP

Este servidor utiliza el Protocolo de Contexto Modelo estándar y puede integrarse con cualquier cliente MCP:

  1. Inicia el servidor:

    npx mixpanel-mcp-server --token YOUR_MIXPANEL_TOKEN

  2. Conecta tu cliente MCP al servidor usando transporte stdio

  3. El cliente puede descubrir y usar las herramientas disponibles (mixpanel_track_event, mixpanel_track_pageview, mixpanel_track_signup, mixpanel_set_user_profile)

Referencia de Herramientas

El servidor MCP de Mixpanel proporciona las siguientes herramientas:

mixpanel_track_event

Rastrea un evento personalizado en Mixpanel.

Parámetros:

  • event_name (cadena, requerido): El nombre del evento a rastrear
  • distinct_id (cadena, opcional): Identificador del usuario. Por defecto es 'anonymous'
  • properties (objeto, opcional): Propiedades adicionales para rastrear con el evento

Ejemplo:

{
  "event_name": "button_clicked",
  "distinct_id": "user123",
  "properties": {
    "button_id": "submit_form",
    "page": "checkout"
  }
}

mixpanel_track_pageview

Rastrea un evento de vista de página en Mixpanel.

Parámetros:

  • page_name (cadena, requerido): El nombre de la página vista
  • distinct_id (cadena, opcional): Identificador del usuario. Por defecto es 'anonymous'
  • referrer (cadena, opcional): La página de referencia

Ejemplo:

{
  "page_name": "homepage",
  "distinct_id": "user123",
  "referrer": "google.com"
}

mixpanel_track_signup

Rastrea un evento de registro y crea un perfil de usuario en Mixpanel.

Parámetros:

  • user_name (cadena, requerido): Nombre completo del usuario
  • email (cadena, requerido): Dirección de correo electrónico del usuario
  • plan (cadena, opcional): Plan de registro. Por defecto es 'free'

Ejemplo:

{
  "user_name": "John Doe",
  "email": "john@example.com",
  "plan": "premium"
}

mixpanel_set_user_profile

Actualiza las propiedades del perfil de un usuario en Mixpanel.

Parámetros:

  • distinct_id (cadena, requerido): Identificador del usuario
  • properties (objeto, requerido): Propiedades del perfil a establecer

Ejemplo:

{
  "distinct_id": "user123",
  "properties": {
    "$name": "John Doe",
    "$email": "john@example.com",
    "plan": "premium",
    "company": "Acme Inc"
  }
}

Ejemplos

Aquí hay algunos ejemplos prácticos de uso del servidor MCP de Mixpanel con Claude:

Rastreo de un Clic en un Botón

You: Can you track an event in Mixpanel when a user clicks the submit button?

Claude: I'll track that event for you. Let me use the Mixpanel analytics tool.

[Claude uses the mixpanel_track_event tool with appropriate parameters]

Claude: I've successfully tracked the 'button_clicked' event in Mixpanel with the properties you specified.

Creación de un Perfil de Usuario

You: Create a new user profile in Mixpanel for Sarah Johnson who signed up with sarah@example.com on the premium plan.

Claude: I'll create that user profile in Mixpanel.

[Claude uses the mixpanel_track_signup tool with appropriate parameters]

Claude: I've successfully tracked the signup for Sarah Johnson and created a profile in Mixpanel with the premium plan.

Solución de Problemas

Problemas Comunes

  1. El servidor no se inicia:

    • Asegúrate de haber proporcionado un token válido de Mixpanel
    • Verifica que Node.js esté instalado y sea la versión 16 o superior

  2. Claude Desktop no muestra las herramientas de Mixpanel:

    • Verifica la sintaxis de tu archivo claude_desktop_config.json
    • Asegúrate de haber reiniciado Claude Desktop después de editar la configuración
    • Comprueba que la ruta al servidor sea correcta

  3. Los eventos no aparecen en Mixpanel:

    • Verifica que tu token de Mixpanel sea correcto
    • Revisa la configuración de tu proyecto en Mixpanel para asegurarte de que los datos se estén recibiendo
    • Los eventos pueden tardar unos minutos en aparecer en la interfaz de Mixpanel

Modo de Depuración

Para ejecutar el servidor en modo de depuración con registro más detallado:

npx mixpanel-mcp-server --token YOUR_MIXPANEL_TOKEN --debug

Notas de Seguridad

  • Tu token de Mixpanel se almacena en el archivo de configuración de Claude Desktop. Asegúrate de que este archivo tenga los permisos adecuados
  • Considera usar variables de entorno para tokens sensibles en entornos de producción
  • Este servidor no implementa limitación de velocidad: considera agregar medidas de seguridad adicionales para uso en producción
  • Los eventos se envían directamente a la API de Mixpanel: revisa la política de privacidad de Mixpanel para conocer las prácticas de manejo de datos

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Solicitud de Extracción (Pull Request).

  1. Haz un fork del repositorio
  2. Crea tu rama de características (git checkout -b feature/amazing-feature)
  3. Realiza tus cambios (git commit -m 'Add some amazing feature')
  4. Envía los cambios a la rama (git push origin feature/amazing-feature)
  5. Abre una Solicitud de Extracción

Licencia

Este proyecto está licenciado bajo la Licencia MIT: consulta el archivo LICENSE para más detalles.