local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Integrates with the Eventbrite API to provide tools for managing events, tracking attendees, and generating analytics reports, including capabilities for viewing, creating, updating, and publishing events, as well as attendee management and sales analytics features.

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.

Estado del proyecto

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

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

Fecha	Descripción	Estado
2025-03-20	Se inició la planificación del proyecto	Terminado
2025-03-20	Documentación revisada de la API de Eventbrite	Terminado
2025-03-20	Se revisaron ejemplos de implementación de servidores MCP	Terminado
2025-03-20	Se creó la documentación inicial del proyecto.	Terminado
2025-03-20	Se implementó la estructura central del servidor MCP	Terminado
2025-03-20	Se implementó el cliente API de Eventbrite	Terminado
2025-03-20	Se implementaron las herramientas list_events y get_event_details	Terminado
2025-03-20	Se creó un cliente MCP de prueba	Terminado
2025-03-20	Se implementó la interfaz de usuario del visor de eventos	Terminado
2025-03-20	Recuperación de eventos probada con filtrado de fechas	Terminado

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

Inicia sesión en tu cuenta de Eventbrite
Vaya a Configuración de la cuenta > Enlaces de desarrollador > Claves API
Copia tu token privado
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)

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Se integra con la API de Eventbrite para proporcionar capacidades de gestión de eventos asistidas por IA para ver eventos, rastrear asistentes y generar informes analíticos.

Eventbrite MCP Server