Eventbrite

Gestiona eventos, informes y análisis en Eventbrite.

Documentación

Servidor MCP de Eventbrite

Un servidor de Model Context Protocol (MCP) para la gestión de eventos, informes y análisis de Eventbrite.

Resumen del Proyecto

Este servidor MCP se integra con la API de Eventbrite para proporcionar herramientas para gestionar eventos, realizar seguimiento de asistentes y generar informes analíticos. Está diseñado para funcionar con Claude y otros clientes MCP para ofrecer capacidades de gestión de eventos asistidas por IA.

Estado del Proyecto

Estado	Descripción
🚧 En Progreso	Funcionalidad básica implementada

Actualmente, están implementadas las siguientes herramientas:

list_events: Listar eventos con filtrado opcional
get_event_details: Obtener información detallada sobre un evento específico

Características

Gestión de Eventos: Ver, crear, actualizar y publicar eventos
Gestión de Asistentes: Listar asistentes, ver detalles y exportar datos de asistentes
Análisis de Ventas: Generar informes sobre ventas de entradas, ingresos y tendencias
Informes Personalizados: Crear y guardar plantillas de informes personalizados
Visualización de Datos: Generar gráficos y diagramas para métricas clave

Plan de Implementación

Fase 1: Configuración e Infraestructura Principal

Inicializar la estructura del proyecto
Configurar el marco del servidor MCP
Implementar la autenticación de la API de Eventbrite
Crear funciones básicas de envoltura de la API

Fase 2: Herramientas de Gestión de Eventos

Implementar la herramienta list_events
Implementar la herramienta get_event_details
Implementar la herramienta create_event
Implementar la herramienta update_event
Implementar la herramienta publish_event

Fase 3: Herramientas de Gestión de Asistentes

Implementar la herramienta list_attendees
Implementar la herramienta get_attendee_details
Implementar la herramienta export_attendee_data

Fase 4: Análisis e Informes

Implementar la herramienta generate_sales_report
Implementar la herramienta generate_attendance_report
Implementar la herramienta generate_analytics_chart
Crear componentes de visualización de datos

Fase 5: Pruebas y Documentación

Implementar cliente MCP de prueba
Crear interfaz web de visualización de eventos
Pruebas exhaustivas de la funcionalidad de listado de eventos
Crear documentación de uso completa
Crear flujos de trabajo de ejemplo

Registro de Desarrollo

Fecha	Descripción	Estado
2025-03-20	Planificación del proyecto iniciada	Completado
2025-03-20	Revisada la documentación de la API de Eventbrite	Completado
2025-03-20	Revisados ejemplos de implementación del servidor MCP	Completado
2025-03-20	Creada la documentación inicial del proyecto	Completado
2025-03-20	Implementada la estructura principal del servidor MCP	Completado
2025-03-20	Implementado el cliente de la API de Eventbrite	Completado
2025-03-20	Implementadas las herramientas list_events y get_event_details	Completado
2025-03-20	Creado el cliente MCP de prueba	Completado
2025-03-20	Implementada la interfaz de visualización de eventos	Completado
2025-03-20	Probada la recuperación de eventos con filtrado por fecha	Completado

Primeros Pasos

Requisitos Previos

Node.js (v18 o superior)
Token de API de Eventbrite (token privado de tu cuenta de Eventbrite)
Claude Desktop u otro cliente MCP

Instalación

# Clone the repository
git clone https://github.com/yourusername/eventbrite-mcp.git

# Install dependencies
cd eventbrite-mcp
npm install

# Configure environment variables
cp .env.example .env
# Edit .env with your Eventbrite API token

# Build the project
npm run build

# Start the server
npm start

Cómo Obtener tu Token de API de Eventbrite

Inicia sesión en tu cuenta de Eventbrite
Ve a Configuración de la Cuenta > Enlaces de Desarrollador > Claves de API
Copia tu token privado
Añádelo a tu archivo .env como EVENTBRITE_API_KEY=tu_token_aquí

Configuración con Claude Desktop

Añade lo siguiente a tu claude_desktop_config.json (ubicado en ~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

Opción 1: Usando npm start

{
  "mcpServers": {
    "eventbrite": {
      "command": "npm",
      "args": ["start"],
      "cwd": "/path/to/eventbrite-mcp",
      "env": {
        "EVENTBRITE_API_KEY": "your_api_token_here"
      }
    }
  }
}

Opción 2: Ejecución directa con Node.js (recomendado)

{
  "mcpServers": {
    "eventbrite": {
      "command": "node",
      "args": ["/path/to/eventbrite-mcp/dist/index.js"],
      "cwd": "/path/to/eventbrite-mcp",
      "env": {
        "EVENTBRITE_API_KEY": "your_api_token_here"
      }
    }
  }
}

Pruebas y Visualizador de Eventos

Este proyecto incluye herramientas para probar el servidor MCP y ver eventos:

Cliente MCP de Prueba

El script test-mcp-client-final.js te permite probar la funcionalidad de recuperación de eventos del servidor MCP:

# Run the test client with default parameters
node test-mcp-client-final.js

# Run with custom date range
node test-mcp-client-final.js --start-date="2025-01-01" --end-date="2025-12-31"

# Run with specific status filter
node test-mcp-client-final.js --status="live"

Visualizador de Eventos

El proyecto incluye un visualizador de eventos basado en web para mostrar y filtrar eventos:

# Start the events viewer
node view-events.js

Esto iniciará un servidor web local y abrirá el visualizador de eventos en tu navegador. El visualizador te permite:

Ver todos los eventos recuperados de Eventbrite
Filtrar eventos por rango de fechas
Filtrar eventos por estado
Ver información detallada de eventos

Si el archivo events.json no existe, el script obtendrá automáticamente los eventos de la API de Eventbrite.

Licencia

MIT