Servidor MCP para Ticketmaster

Un servidor de protocolo de contexto de modelo que proporciona herramientas para descubrir eventos, lugares y atracciones a través de la API de descubrimiento de Ticketmaster.

Características

• Busque eventos, lugares y atracciones con filtros flexibles:

  • Búsqueda de palabras clave

  • Rango de fechas para eventos

  • Ubicación (ciudad, estado, país)

  • Búsquedas específicas del lugar

  • Búsquedas específicas de atracciones

  • Clasificaciones/categorías de eventos

• Formatos de salida:

  • Datos JSON estructurados para uso programático

  • Texto legible para consumo directo

• Datos completos que incluyen:

  • Nombres e identificaciones

  • Fechas y horarios (para eventos)

  • Rangos de precios (para eventos)

  • URL

  • Imágenes

  • Ubicaciones y direcciones (para lugares)

  • Clasificaciones (para atracciones)

Instalación

Configuración

El servidor requiere una clave API de Ticketmaster. Puedes obtenerla de la siguiente manera:

1. Ir a https://developer.ticketmaster.com/

2. Crear una cuenta o iniciar sesión

3. Vaya a "Mis aplicaciones" en su cuenta

4. Creando una nueva aplicación para obtener tu clave API

Establezca su clave API en su archivo de configuración MCP:

Uso

El servidor proporciona una herramienta llamada search_ticketmaster que acepta:

Parámetros requeridos

• type : Tipo de búsqueda ('evento', 'lugar' o 'atracción')

Parámetros opcionales

• keyword : término de búsqueda

• startDate : Fecha de inicio en formato AAAA-MM-DD (para eventos)

• endDate : Fecha de finalización en formato AAAA-MM-DD (para eventos)

• city : Nombre de la ciudad

• stateCode : código de estado (p. ej., 'NY')

• countryCode : Código de país (por ejemplo, 'EE. UU.')

• venueId : ID de lugar específico

• attractionId : ID de atracción específica

• classificationName : Categoría del evento (p. ej., 'Deportes', 'Música')

• format : Formato de salida ('json' o 'texto', predeterminado 'json')

Ejemplos

Salida JSON estructurada (predeterminada)

Salida de texto legible para humanos

Desarrollo

1. Clonar el repositorio

2. Copie el archivo de entorno de ejemplo:

   cp .env.example .env

3. Agregue su clave API de Ticketmaster a .env

4. Instalar dependencias:

   npm install

5. Construir el proyecto:

   npm run build

6. Prueba con el inspector:

   npm run inspector

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios. Para cambios importantes, primero abra una incidencia para comentar qué desea cambiar.

Licencia

Licencia MIT: consulte el archivo de LICENCIA para obtener más detalles