Servidor MCP de Eventbrite

Un servidor de Protocolo de contexto de modelo (MCP) para la gestión, informes y análisis de eventos de Eventbrite.

Descripción general del proyecto

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

Related MCP server: Microsoft Events MCP Server

Estado del proyecto

Actualmente se encuentran implementadas las siguientes herramientas:

• list_events : Lista de 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 : enumere a los asistentes, vea detalles y exporte datos de los asistentes

• Análisis de ventas : genere informes sobre ventas de entradas, ingresos y tendencias

• Informes personalizados : cree y guarde plantillas de informes personalizados

• Visualización de datos : genere gráficos y tablas para métricas clave

Plan de Implementación

Fase 1: Configuración e infraestructura central

• [x] Inicializar la estructura del proyecto

• [x] Configurar el marco del servidor MCP

• [x] Implementar la autenticación de la API de Eventbrite

• [x] Crear funciones básicas de contenedor de API

Fase 2: Herramientas de gestión de eventos

• [x] Implementar la herramienta list_events

• [x] 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

• [x] Implementar el cliente MCP de prueba

• [x] Crear una interfaz web para visualizar eventos

• [x] Pruebas exhaustivas de la funcionalidad de listado de eventos

• [ ] Crear documentación de uso completa

• [ ] Crear flujos de trabajo de ejemplo

Registro de desarrollo

Empezando

Prerrequisitos

• Node.js (v18 o superior)

• Token de API de Eventbrite (token privado de su 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

1. Inicia sesión en tu cuenta de Eventbrite

2. Vaya a Configuración de la cuenta > Enlaces de desarrollador > Claves API

3. Copia tu token privado

4. Agréguelo a su archivo .env como EVENTBRITE_API_KEY=your_token_here

Configuración con Claude Desktop

Agregue lo siguiente a su claude_desktop_config.json (ubicado en ~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

Opción 1: Usar 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 de Node.js (recomendada)

{
  "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 visor de eventos

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

Probar cliente MCP

El script test-mcp-client-final.js le 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"

Visor de eventos

El proyecto incluye un visor 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 visor de eventos en su navegador. El visor le permite:

• Ver todos los eventos recuperados de Eventbrite

• Filtrar eventos por rango de fechas

• Filtrar eventos por estado

• Ver información detallada del evento

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

Licencia

Instituto Tecnológico de Massachusetts (MIT)