Servidor MCP de Eventbrite

Este es un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para interactuar con la API de Eventbrite. Permite a los asistentes de IA buscar eventos, obtener detalles de los mismos, recuperar información del recinto y mucho más.

Características

• Busca eventos según diversos criterios (ubicación, fecha, categoría, etc.)
• Obtenga información detallada sobre eventos específicos
• Recuperar información del lugar
• Obtenga una lista de categorías de eventos

Instalación

Del NPM

De la fuente

1. Clonar este repositorio
2. Instalar dependencias:
   npm install
3. Construir el proyecto:
   npm run build

Desarrollo

Ejecutando en modo de desarrollo

Esto buscará cambios en los archivos de origen, reconstruirá el proyecto y reiniciará el servidor automáticamente.

Ejecución del servidor MCP

Puede ejecutar el servidor MCP utilizando el script de ejecución proporcionado:

Esto iniciará el servidor MCP usando supergateway.

Corriendo con Inspector

Para ejecutar el servidor MCP con el Inspector, puede utilizar:

Esto iniciará el Inspector, que proporciona una interfaz web para probar el servidor MCP. El Inspector estará disponible en http://localhost:5173 .

Ejecutar manualmente

Puede ejecutar el servidor MCP manualmente usando:

O simplemente utilice el script de ejecución proporcionado:

Pruebas

Configuración

Para utilizar este servidor MCP, necesita:

1. Obtenga una clave API de Eventbrite desde el Portal para desarrolladores de Eventbrite
2. Configure su clave API de una de las siguientes maneras:
   • Cree un archivo .env en la raíz del proyecto (copie desde .env.example ):
     EVENTBRITE_API_KEY=your_eventbrite_api_key_here
   • O proporcionarlo como una variable de entorno:
     export EVENTBRITE_API_KEY=your_eventbrite_api_key_here
   • O configúrelo en el archivo de configuración de MCP (ver a continuación)
3. Pruebe su clave API:
   ./test-api-key.js
4. Configure el servidor MCP en su archivo de configuración de MCP

Para la aplicación de escritorio de Claude

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

Para el entorno de desarrollo de Claude

Agregue lo siguiente a su archivo ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json (en macOS):

Inicio rápido

Si lo ha instalado desde la fuente, puede utilizar el script de ejecución proporcionado:

Esto construirá el proyecto e iniciará el servidor MCP.

Herramientas disponibles

eventos de búsqueda

Busque eventos de Eventbrite según varios criterios.

Parámetros:

• query (cadena, opcional): consulta de búsqueda de eventos
• location (objeto, opcional): Ubicación para buscar alrededor
  • latitude (número, obligatorio): coordenada de latitud
  • longitude (número, obligatorio): coordenada de longitud
  • within (cadena, opcional): Distancia (por ejemplo, '10 km', '10 mi')
• categories (matriz de cadenas, opcional): ID de categorías para filtrar por
• start_date (cadena, opcional): fecha de inicio en formato ISO (por ejemplo, '2023-01-01T00:00:00Z')
• end_date (cadena, opcional): fecha de finalización en formato ISO (por ejemplo, '2023-12-31T23:59:59Z')
• price (cadena, opcional): Filtrar por eventos 'gratuitos' o 'pagos'
• page (número, opcional): Número de página para paginación
• page_size (número, opcional): Número de resultados por página (máximo 100)

obtener_evento

Obtenga información detallada sobre un evento específico de Eventbrite.

Parámetros:

• event_id (cadena, obligatoria): ID del evento de Eventbrite

obtener_categorías

Obtenga una lista de categorías de eventos de Eventbrite.

No se requieren parámetros.

obtener_lugar

Obtenga información sobre un lugar específico de Eventbrite.

Parámetros:

• venue_id (cadena, obligatoria): ID del lugar de celebración de Eventbrite

Recursos disponibles

Recursos de detalles del evento

Plantilla de URI: eventbrite://events/{eventId}

Obtenga información detallada sobre un evento específico de Eventbrite.

Ejemplo de uso

Una vez configurado, puedes pedirle a Claude que use las herramientas Eventbrite MCP:

• Busca eventos musicales en Nueva York el próximo fin de semana.
• Obtener detalles del evento de Eventbrite con ID 123456789
• ¿Qué categorías de eventos están disponibles en Eventbrite?
• "Cuéntame sobre el lugar con ID 987654321"

Licencia

Instituto Tecnológico de Massachusetts (MIT)