API de la NHL - Protocolo de contexto del modelo

Una implementación en TypeScript de la API de la NHL que utiliza el patrón de Protocolo Modelo-Contexto. Este servidor MCP proporciona acceso a datos de la NHL, incluyendo equipos, jugadores, clasificaciones, calendarios y estadísticas.

Descripción general

Esta biblioteca proporciona una interfaz clara para las API oficiales de la NHL mediante el Protocolo Modelo-Contexto (MCP). Permite obtener datos de las API de la NHL y proporcionarlos en un formato estructurado y fácil de usar mediante herramientas MCP.

📊 Estado actual

A partir del 10 de marzo de 2025, la plataforma ofrece la siguiente funcionalidad:

✅ Funciones de trabajo

1. Clasificación

   • Clasificación de toda la liga con desglose de divisiones

   • Información completa del registro del equipo

2. Equipos

   • Información básica de identidad del equipo

   • Información actual de la plantilla con detalles de los jugadores

   • Estadísticas del equipo (patinadores y porteros)

   • Seguimiento de prospectos

3. Jugadores

   • Información biográfica del jugador

   • Estadísticas de la temporada actual y de su carrera

   • Reconocimiento de premios

4. Horarios

   • Horarios actuales del equipo

   • Horarios de liga con fechas específicas

   • Información sobre los próximos juegos

5. Estadística

   • Líderes estadísticos actuales (patinadores y porteros)

   • Desgloses estadísticos específicos del equipo

6. Información del juego

   • Resultados y estado de los juegos en vivo

   • Horarios de los juegos

❌ Problemas identificados

1. Brechas de información del equipo

   • Falta información sobre la división del equipo y la conferencia en la búsqueda del equipo

   • Datos básicos del equipo incompletos (faltan detalles de ciudad y ubicación)

2. Detalles del juego

   • Información limitada sobre el estado del juego para juegos en curso

   • La implementación de datos jugada por jugada necesita más pruebas

3. Datos históricos

   • El acceso a los datos históricos estacionales necesita verificación

   • La recuperación del cronograma histórico requiere pruebas adicionales

4. Integración de UI

   • No hay componentes de interfaz de usuario actuales para la visualización de datos

   • El formato de datos sin procesar requiere transformación para su visualización en la interfaz

Lista de tareas pendientes

Alta prioridad

• [ ] Se corrigió la API de información del equipo para incluir detalles completos del equipo (división, conferencia, ubicación)

• [ ] Implementar un seguimiento más detallado del estado del juego para juegos en vivo

• [ ] Crear capas de transformación de datos para la integración de la interfaz de usuario

• [ ] Pruebas completas de puntos finales de datos históricos

Prioridad media

• [ ] Desarrollar componentes estándar de visualización de datos

• [ ] Agregar integración de imágenes de jugadores

• [ ] Implementar activos de marca/logotipo del equipo

• [ ] Crear funcionalidad de búsqueda en todos los tipos de datos

Baja prioridad

• [ ] Construir un sistema de almacenamiento en caché para datos a los que se accede con frecuencia

• [ ] Añadir puntos de integración de hockey de fantasía

• [ ] Desarrollar la integración de noticias/medios

• [ ] Agregar conexiones de contenido de redes sociales

🚀 Primeros pasos

1. Clonar el repositorio:

   git clone https://github.com/yourusername/nhl-mcp.git cd nhl-mcp

2. Instalar dependencias:

   npm install

3. Configurar las credenciales de API:

   cp .env.example .env # Edit .env with your API keys

4. Inicie el servidor de desarrollo:

   npm run dev

Referencia de API

La plataforma NHL-MCP proporciona los siguientes puntos finales de API principales:

Equipos

• get-team : recupera información básica del equipo

• get-team-roster : Obtener la lista actual del equipo

• get-team-stats : Obtener estadísticas del equipo

• get-team-prospects : obtener información de los prospectos del equipo

Jugadores

• get-player-landing : obtener información detallada del jugador

Clasificación

• get-current-standings : Consulta la clasificación actual de la NHL

Cronograma

• get-schedule : Obtener información general del cronograma

• get-current-schedule : Obtener el próximo calendario de un equipo

• get-date-schedule : Obtener el horario para una fecha específica

Estadística

• get-current-stat-leaders : Obtener líderes estadísticos actuales

• get-current-goalie-leaders : Obtén los líderes estadísticos de porteros actuales

Juegos

• get-scores-now : obtén puntuaciones actuales y estados del juego

📄 Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

🤝 Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

1. Bifurcar el repositorio

2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )

3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )

4. Empujar a la rama ( git push origin feature/amazing-feature )

5. Abrir una solicitud de extracción

📞 Contacto

Mantenedor del proyecto: Dylan Groos

Nota: Este README documenta el estado actual del proyecto NHL-MCP según las pruebas realizadas el 10 de marzo de 2025. La plataforma accede a datos de la NHL que están sujetos a los términos y condiciones establecidos por la Liga Nacional de Hockey.