MLB SportRadar

Acesse dados de jogos da MLB, classificações e estatísticas de jogadores usando a API SportRadar.

GitHub
1
Experimente este MCPPatrocinado

Documentação

Servidor MCP MLB SportRadar

Servidor Model Context Protocol (MCP) para conectar o Claude à API MLB do SportRadar. Ele fornece ferramentas para acessar dados de jogos da MLB, classificações, estatísticas de jogadores e muito mais por meio da API do SportRadar.

Requisitos

  • Python 3.12 ou superior
  • SDK Python do Model Context Protocol (MCP)
  • httpx
  • python-dotenv
  • Chave da API do SportRadar

Configuração

1. Obter a chave da API do SportRadar

  1. Cadastre-se no Portal do Desenvolvedor SportRadar
  2. Obtenha sua chave da API da MLB (avaliação ou produção)

2. Instalar o uv (recomendado)

curl -LsSf https://astral.sh/uv/install.sh | sh

3. Clonar este repositório

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

4. Criar e ativar um ambiente virtual

# Create virtual environment
uv venv

# Activate virtual environment
# On macOS/Linux:
source .venv/bin/activate
# On Windows:
.venv\Scripts\activate

5. Instalar as dependências

# Option 1: Using uv (recommended)
uv sync

# Option 2: Using pip with requirements.txt
pip install -r requirements.txt

# Option 3: Install as editable package
uv pip install -e .

6. Configurar as variáveis de ambiente

Crie um arquivo .env na raiz do projeto com sua chave da API do SportRadar:

SPORTRADAR_API_KEY=your_api_key_here

Uso

1. Configurar o Claude Desktop

Primeiro, instale a CLI do MCP globalmente:

uv tool install "mcp[cli]"

Em seguida, adicione este servidor ao arquivo de configuração do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json no macOS):

{
  "mcpServers": {
    "MLB SportRadar": {
      "command": "/Users/<USERNAME>/.local/share/uv/tools/mcp/bin/mcp",
      "args": ["run", "/full/path/to/mlb-sportradar-mcp/src/mlb_sportradar_mcp/server.py"]
    }
  }
}

Importante: Substitua /full/path/to/ pelo caminho absoluto real do seu diretório mlb-sportradar-mcp.

Reinicie o Claude Desktop após salvar a configuração.

2. Usar o servidor MCP com o Claude

Uma vez configurado, o Claude Desktop terá acesso a estas ferramentas do MLB SportRadar:

Dados de Jogos:

  • get_daily_schedule: Obter a programação da MLB para uma data específica ou hoje
  • get_game_summary: Obter informações resumidas de um jogo específico
  • get_game_boxscore: Obter o boxscore detalhado de um jogo específico
  • get_game_play_by_play: Obter dados detalhados de jogada a jogada de um jogo
  • get_game_pitch_metrics: Obter métricas de arremesso e dados Statcast

Equipe e Liga:

  • get_standings: Obter classificações da MLB para um ano e liga específicos
  • get_team_profile: Obter informações detalhadas da equipe
  • get_team_roster: Obter a lista atual de jogadores de uma equipe específica
  • get_team_hierarchy: Obter a hierarquia completa das equipes da MLB com divisões
  • get_seasonal_statistics: Obter estatísticas sazonais de uma equipe

Dados de Jogadores:

  • get_player_profile: Obter informações detalhadas do jogador
  • get_player_seasonal_stats: Obter estatísticas sazonais de um jogador
  • get_seasonal_splits: Obter divisões do jogador (casa/fora, contra canhoto/destro, etc.)
  • get_league_leaders: Obter líderes da liga MLB em várias categorias

Informações da Liga:

  • get_injuries: Obter o relatório atual de lesões da MLB
  • get_transactions: Obter transações da MLB para uma data específica
  • get_draft_summary: Obter o resumo do draft da MLB para um ano específico

Exemplos de consultas para experimentar com o Claude:

  • "Mostre-me a programação da MLB de hoje"
  • "Obtenha as classificações atuais da Liga Americana"
  • "Quais são os líderes atuais em rebatidas na MLB?"
  • "Mostre-me o relatório de lesões da MLB"
  • "Obtenha dados de jogada a jogada para o jogo [game_id]"
  • "Mostre-me as métricas de arremesso do último jogo"
  • "Obtenha divisões do jogador para [player_name]"
  • "Quais transações aconteceram hoje na MLB?"

Desenvolvimento e testes

Instale as dependências de desenvolvimento e execute a suíte de testes com:

uv sync --all-extras
pytest -v tests

Executando o servidor localmente

Para iniciar o servidor manualmente (útil ao desenvolver ou testar), execute:

mlb-sportradar-mcp

Alternativamente, você pode executá-lo diretamente com:

uv run python src/mlb_sportradar_mcp/server.py

Instalando a CLI do MCP globalmente

Se você quiser usar os comandos mcp run, instale a CLI do MCP globalmente:

uv tool install "mcp[cli]"

Então você pode executar:

mcp run src/mlb_sportradar_mcp/server.py

Endpoints da API

Este servidor MCP usa os endpoints da API v8 do SportRadar MLB:

  • Programação: /en/games/{year}/{month}/{day}/schedule.json
  • Resumo do Jogo: /en/games/{game_id}/summary.json
  • Boxscore do Jogo: /en/games/{game_id}/boxscore.json
  • Classificações: /en/seasons/{year}/standings.json
  • Perfil do Jogador: /en/players/{player_id}/profile.json
  • Perfil da Equipe: /en/teams/{team_id}/profile.json
  • Líderes da Liga: /en/seasons/{year}/leaders.json
  • Lista de Jogadores da Equipe: /en/teams/{team_id}/roster.json
  • Lesões: /en/injuries.json

Limites de Taxa

Esteja ciente dos limites de taxa da API do SportRadar. A API de avaliação geralmente tem limites mais baixos do que as chaves de produção. Monitore seu uso para evitar atingir os limites de taxa.

Licença

MIT

Alteração de teste