NBA MCP Server

Servidor MCP de la NBA

Un servidor en Python que implementa el Protocolo de Contexto de Modelo (MCP) para estadísticas de la NBA y datos de juegos en vivo.

Descripción general

Este servidor proporciona un conjunto de herramientas para acceder a datos de la NBA a través de la API de la NBA. Actúa como un puente entre aplicaciones y los servicios de datos de la NBA, ofreciendo tanto información de juegos en vivo como estadísticas históricas.

Características

• Datos de juegos en vivo (marcador, estadísticas del juego, jugada por jugada)
• Información de jugadores y estadísticas de carrera
• Registros de juegos y estadísticas de equipos
• Clasificaciones de la liga
• Resultados de juegos y calendarios

Herramientas

Datos de juegos en vivo

• nba_live_scoreboard

  • Obtener el marcador de la NBA de hoy (en vivo o el más reciente)
  • Devuelve IDs de juegos, horarios de inicio, puntuaciones y detalles de transmisión

• nba_live_boxscore

  • Obtener el marcador detallado en tiempo real para un ID de juego de la NBA dado
  • Proporciona estadísticas detalladas de jugadores y equipos

• nba_live_play_by_play

  • Recuperar acciones jugada por jugada en vivo para un juego específico
  • Incluye jugadas de anotación, faltas, tiempos muertos y sustituciones

Información de jugadores

• nba_common_player_info

  • Recuperar información básica sobre un jugador
  • Incluye datos biográficos, altura, peso, equipo, posición

• nba_player_career_stats

  • Obtener las estadísticas de carrera de un jugador
  • Disponible en diferentes formatos (por juego, totales, por 36 minutos)

• nba_list_active_players

  • Devolver una lista de todos los jugadores actualmente activos de la NBA

• nba_player_game_logs

  • Obtener las estadísticas de juego de un jugador dentro de un rango de fechas especificado

Datos de equipos

• nba_team_game_logs_by_name

  • Obtener los registros de juegos de un equipo usando el nombre del equipo
  • Evita la necesidad de conocer el ID numérico del equipo

• nba_fetch_game_results

  • Obtener resultados de juegos para un ID de equipo y rango de fechas dado

• nba_team_standings

  • Obtener las clasificaciones de equipos de la NBA para una temporada y tipo de temporada dado

• nba_team_stats_by_name

  • Obtener estadísticas de equipo usando el nombre del equipo
  • Admite diferentes métodos de agregación (totales, por juego, etc.)

• nba_all_teams_stats

  • Obtener estadísticas para todos los equipos de la NBA en múltiples temporadas

Información de calendario

• nba_list_todays_games
  • Devuelve datos del marcador para cualquier fecha específica

Uso

El servidor se implementa utilizando el marco MCP y puede ejecutarse como un servicio independiente.

# Start the server
python nba_server.py
# or
mcp run nba_server.py

Configuración

• El servidor se ejecuta con un tiempo de espera de 30 segundos para una operación más confiable
• Se implementan manejadores de señales para un apagado elegante (Ctrl+C)

Uso con Claude Desktop

Opción 1: Usando Docker (Recomendado)

1. Clonar este repositorio

git clone https://github.com/obinopaul/nba-mcp-server.git
cd nba-mcp-server

2. Instalar dependencias

pip install -r requirements.txt

3. Construir la imagen de Docker

docker build -t nba_mcp_server .

4. Ejecutar el contenedor de Docker

docker run -d -p 5000:5000 --name nba_mcp_server nba_mcp_server

5. Agregar esto a tu claude_desktop_config.json:

{
  "mcpServers": {
    "nba_mcp_server": {
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "nba_mcp_server",
        "python",
        "nba_server.py"
      ]
    }
  }
}

Opción 2: Ejecución directa con Python

1. Clonar este repositorio

git clone https://github.com/obinopaul/nba-mcp-server.git
cd nba-mcp-server

2. Crear un nuevo entorno

conda create --name your_env_name python=3.13
conda activate your_env_name

3. Instalar dependencias

pip install -r requirements.txt

4. Ejecutar el servidor MCP de la NBA en la terminal

mcp run nba_server.py

5. Agregar esto a tu claude_desktop_config.json, ajustando la ruta de Python según sea necesario:

{
  "mcpServers": {
    "nba_mcp_server": {
      "command": "/path/to/your/python",
      "args": [
        "/path/to/nba_server.py"
      ]
    }
  }
}

Después de agregar tu configuración elegida, reinicia Claude Desktop para cargar el servidor de la NBA. Podrás usar todas las herramientas de datos de la NBA en tus conversaciones con Claude.

Detalles técnicos

El servidor está construido sobre:

• Paquete de Python de la API de la NBA (nba_api)
• MCP para la interfaz de API
• Pydantic para la validación de entrada
• Pandas para la manipulación de datos

Licencia

Este servidor MCP está disponible bajo la Licencia MIT.