Baseball MCP

baseball-mcp: Un envoltorio de la MLB Stats API para MCP

Este proyecto proporciona un MCP (Model Context Protocol) que actúa como un envoltorio para la MLB Stats API. Permite acceder y procesar fácilmente varios puntos de datos de MLB, incluyendo calendarios, resultados de juegos e información de equipos. Este servidor está diseñado para la recuperación y procesamiento eficiente de datos dentro de un marco MCP.

Videos de demostración

Aquí hay un par de videos de demostración que muestran las capacidades de mcp_mlb_statsapi:

• Demo 1: MCP MLB Stats API - Resumen rápido

• 

• Demo 2: MCP MLB Stats API - 輸入中文也可以

• 

Características

• Calendarios de juegos: Recupera calendarios de juegos de MLB para rangos de fechas específicos, opcionalmente filtrando por equipo.
• Resultados de juegos: Obtén resultados diarios de juegos, incluyendo puntuaciones, equipos ganadores/perdedores y lanzador ganador.
• Resultados de equipos: Obtén resultados detallados del juego más reciente de un equipo específico, incluyendo jugadas de anotación y momentos destacados.
• Búsqueda de jugadores: Busca IDs de jugadores usando apellido, nombre o una combinación de ambos. Soporta coincidencias aproximadas.

Instalación

Requisitos previos

• Python 3.10 o más reciente
• Administrador de paquetes uv:

Si estás en Mac, instala uv de la siguiente manera

brew install uv

En Windows

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

De lo contrario, las instrucciones de instalación están en su sitio web: Instalar uv

Instalar vía PyPI

El paquete mcp_mlb_statsapi está disponible en PyPI y se puede instalar usando pip:

pip install mcp_mlb_statsapi

Instalar vía Github

o puedes clonar este repositorio, ejecutarlo con el código fuente.

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

Integración con Claude para Desktop

Ve a Claude > Configuración > Desarrollador > Editar configuración > claude_desktop_config.json para incluir lo siguiente:

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

Si lo instalas vía código fuente

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

Contribuciones

¡Las contribuciones son bienvenidas! Por favor abre un issue o envía un pull request.

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que eres libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulta el archivo LICENSE en el repositorio del proyecto.

Referencias

Este proyecto utiliza las siguientes bibliotecas y recursos externos:

• MLB-StatsAPI: https://github.com/toddrob99/MLB-StatsAPI - Una biblioteca de Python que proporciona acceso a la MLB Stats API. Este proyecto depende en gran medida de mlb-statsapi para la recuperación de datos.