Baseball MCP

baseball-mcp: Um wrapper da API MLB Stats para MCP

Este projeto fornece um MCP (Model Context Protocol) que atua como um wrapper para a MLB Stats API. Ele permite que você acesse e processe facilmente vários pontos de dados da MLB, incluindo calendários, resultados de jogos e informações de equipes. Este servidor é projetado para recuperação e processamento eficiente de dados dentro de um framework MCP.

Vídeos de Demonstração

Aqui estão alguns vídeos de demonstração mostrando as capacidades de mcp_mlb_statsapi:

• Demo 1: MCP MLB Stats API - Visão Geral Rápida

• 

• Demo 2: MCP MLB Stats API - Inserir chinês também funciona

• 

Recursos

• Calendários de Jogos: Recupere calendários de jogos da MLB para intervalos de datas especificados, opcionalmente filtrando por equipe.
• Resultados de Jogos: Obtenha resultados diários de jogos, incluindo pontuações, times vencedores/perdedores e arremessador vencedor.
• Resultados de Equipes: Obtenha resultados detalhados do jogo mais recente de uma equipe específica, incluindo jogadas de pontuação e destaques.
• Consulta de Jogador: Consulte IDs de jogadores usando sobrenome, nome ou uma combinação de ambos. Suporta correspondência difusa.

Instalação

Pré-requisitos

• Python 3.10 ou mais recente
• gerenciador de pacotes uv:

Se você estiver no Mac, instale o uv da seguinte forma:

brew install uv

No Windows

powershell -c "irm https://astral.sh/uv/install.ps1 | iex" 

Caso contrário, as instruções de instalação estão no site deles: Instalar uv

Instalação via PyPI

O pacote mcp_mlb_statsapi está disponível no PyPI e pode ser instalado usando pip:

pip install mcp_mlb_statsapi

Instalação via GitHub

ou você pode clonar este repositório e executá-lo com o código-fonte.

uv venv
source .venv/bin/activate
uv pip install -r requirements.txt

Integração com Claude for Desktop

Vá para Claude > Configurações > Desenvolvedor > Editar Configuração > claude_desktop_config.json para incluir o seguinte:

    {
      "mcpServers": {
        "mcp_mlb_statsapi": {
           "command": "{YOUR_PYTHON_EXECUTABLE_PATH}/python",
            "args": ["-m",
            "mcp_mlb_statsapi"]
          }
        }
    }

Se você instalá-lo via código-fonte

{
  "mcpServers": {
    "mcp_mlb_statsapi": {
        "command": "{YOUR_UV_EXECUTABLE_PATH}/uv",
        "args": [
            "--directory",
            "{YOUR_PROJECT_PATH}/src/mcp_mlb_statsapi",
            "run",
            "mcp_mlb_statsapi"
        ]
    }
  }
}

Contribuindo

Contribuições são bem-vindas! Por favor, abra uma issue ou envie um pull request.

Licença

Este servidor MCP é licenciado sob a Licença MIT. Isso significa que você é livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.

Referências

Este projeto utiliza as seguintes bibliotecas e recursos externos:

• MLB-StatsAPI: https://github.com/toddrob99/MLB-StatsAPI - Uma biblioteca Python que fornece acesso à MLB Stats API. Este projeto depende fortemente de mlb-statsapi para recuperação de dados.