NHL MCP Server

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.