NBA MCP Server

NBA MCP Server

Um servidor Python que implementa o Model Context Protocol (MCP) para estatísticas da NBA e dados de jogos ao vivo.

Visão Geral

Este servidor fornece um conjunto de ferramentas para acessar dados da NBA através da NBA API. Ele atua como uma ponte entre aplicações e os serviços de dados da NBA, oferecendo tanto informações de jogos ao vivo quanto estatísticas históricas.

Recursos

• Dados de jogos ao vivo (placar, box score, play-by-play)
• Informações de jogadores e estatísticas de carreira
• Logs de jogos e estatísticas de times
• Classificação da liga
• Resultados de jogos e calendários

Ferramentas

Dados de Jogos ao Vivo

• nba_live_scoreboard

  • Busca o placar da NBA de hoje (ao vivo ou mais recente)
  • Retorna IDs de jogos, horários de início, pontuações e detalhes de transmissão

• nba_live_boxscore

  • Busca o box score em tempo real para um ID de jogo da NBA
  • Fornece estatísticas detalhadas de jogadores e times

• nba_live_play_by_play

  • Recupera ações de play-by-play ao vivo para um jogo específico
  • Inclui jogadas de pontuação, faltas, tempos técnicos e substituições

Informações de Jogadores

• nba_common_player_info

  • Recupera informações básicas sobre um jogador
  • Inclui dados biográficos, altura, peso, time, posição

• nba_player_career_stats

  • Obtém as estatísticas de carreira de um jogador
  • Disponível em diferentes formatos (por jogo, totais, por 36 minutos)

• nba_list_active_players

  • Retorna uma lista de todos os jogadores atualmente ativos na NBA

• nba_player_game_logs

  • Obtém as estatísticas de jogos de um jogador dentro de um intervalo de datas especificado

Dados de Times

• nba_team_game_logs_by_name

  • Busca os logs de jogos de um time usando o nome do time
  • Evita a necessidade de saber o ID numérico do time

• nba_fetch_game_results

  • Busca resultados de jogos para um ID de time e intervalo de datas

• nba_team_standings

  • Busca a classificação dos times da NBA para uma temporada e tipo de temporada

• nba_team_stats_by_name

  • Busca estatísticas de times usando o nome do time
  • Suporta diferentes métodos de agregação (totais, por jogo, etc.)

• nba_all_teams_stats

  • Busca estatísticas de todos os times da NBA em múltiplas temporadas

Informações de Calendário

• nba_list_todays_games
  • Retorna dados do placar para qualquer data específica

Uso

O servidor é implementado usando o framework MCP e pode ser executado como um serviço independente.

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

Configuração

• O servidor executa com um timeout de 30 segundos para operação mais confiável
• Handlers de sinal são implementados para desligamento gracioso (Ctrl+C)

Uso com Claude Desktop

Opção 1: Usando Docker (Recomendado)

1. Clone este repositório

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

2. Instale as dependências

pip install -r requirements.txt

3. Construa a imagem Docker

docker build -t nba_mcp_server .

4. Execute o contêiner Docker

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

5. Adicione isso ao seu claude_desktop_config.json:

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

Opção 2: Execução Direta em Python

1. Clone este repositório

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

2. Crie um novo ambiente

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

3. Instale as dependências

pip install -r requirements.txt

4. Execute o servidor MCP da NBA no terminal

mcp run nba_server.py

5. Adicione isso ao seu claude_desktop_config.json, ajustando o caminho do Python conforme necessário:

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

Após adicionar a configuração escolhida, reinicie o Claude Desktop para carregar o servidor da NBA. Você poderá então usar todas as ferramentas de dados da NBA em suas conversas com o Claude.

Detalhes Técnicos

O servidor é construído com:

• Pacote Python NBA API (nba_api)
• MCP para interface de API
• Pydantic para validação de entrada
• Pandas para manipulação de dados

Licença

Este servidor MCP está disponível sob a Licença MIT.