Soccerdata MCP Server

Proporciona información en tiempo real de partidos de fútbol desde la SoccerDataAPI usando lenguaje natural.

GitHub
39

Documentación

MseeP.ai Security Assessment Badge

⚽️ Soccerdata MCP Server

smithery badge

  • MCP-Soccerdata es un servidor de Model Context Protocol (MCP) de código abierto que se conecta a la SoccerDataAPI para ofrecer información actualizada de partidos de fútbol mediante interacciones en lenguaje natural.

  • Diseñado para su uso con clientes compatibles con MCP, como Claude Desktop, permite a los usuarios recuperar datos de fútbol aprovechando los grandes modelos de lenguaje (LLMs).

✨ Funcionalidades

🏟️ Información en Vivo de Partidos de Fútbol

MCP-Soccerdata se centra en ofrecer información en tiempo real sobre los partidos de fútbol en curso en todo el mundo.

"¿Qué partidos de fútbol se están jugando ahora mismo?"
"¿Cuáles son las alineaciones previstas para el PSG contra el Aston Villa hoy?"
"Por favor, dime los marcadores y el número de goles de los partidos de fútbol recientes."

→ Proporciona datos de fútbol relevantes en un formato estructurado, incluyendo las categorías detalladas que se describen a continuación.

- Listados de Partidos e Información Básica

  • Lista global de todos los partidos actualmente activos
  • Nombres de los equipos local y visitante
  • Hora de inicio y fecha del partido
  • Detalles del estadio
  • Marcador actual

- Detalles del Partido

  • Estado del partido: programado, en curso o finalizado
  • Desglose de goles: primer tiempo, segundo tiempo, tiempo extra, tanda de penales
  • Resultado final: victoria, empate o derrota

- Eventos Clave del Partido

  • Eventos de gol (quién marcó, cuándo, cómo)
  • Sustituciones
  • Tarjetas amarillas y rojas
  • Penales

- Alineaciones de los Equipos

  • Once inicial
  • Jugadores suplentes
  • Estado de lesiones
  • Formación del equipo

- Cuotas e Información de Apuestas

  • Cuotas de victoria / empate / derrota
  • Cuotas de más / menos
  • Cuotas de apuestas con hándicap

- Metadatos de la Liga

  • Nombre de la liga
  • País
  • Formato de competición (por ejemplo, temporada regular, fase eliminatoria)

⚠️ Centrado exclusivamente en partidos en vivo, próximos y recientemente finalizados

🎥 Demo

mcp (3) (1)

🚀 Inicio Rápido

Instalación mediante Smithery

Para instalar Amadeus MCP Server para Claude Desktop automáticamente a través de Smithery:

npx -y @smithery/cli install @yeonupark/mcp-soccer-data --client claude

Requisitos Previos

  • Python 3.12+
  • Gestor de paquetes uv
  • Cuenta de Soccerdata API
  • Cliente compatible con MCP (por ejemplo, Claude for Desktop)

1. Clonar y Configurar

  • Clonar el repositorio
git clone https://github.com/yeonupark/mcp-soccer-data.git
cd mcp-soccer-data
  • Instalar dependencias
uv sync

2. Obtener tu Clave de API y Configurar el Entorno

  • Crea un archivo .env con tus credenciales:
AUTH_KEY=your_auth_key

Regístrate en https://soccerdataapi.com/ y obtén tus propias claves de autenticación.

3. Configurar el Cliente MCP

  • Registra este servidor en tu cliente MCP (por ejemplo, Claude for Desktop).

Editar ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
      "mcp-soccer-data": {
          "command": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/uv",
          "args": [
              "--directory",
              "/ABSOLUTE/PATH/TO/PARENT/FOLDER/src/",
              "run",
              "--env-file",
              "/ABSOLUTE/PATH/TO/PARENT/FOLDER/.env",
              "server.py"
          ]
      }
  }
}

🛠️ Herramientas

La siguiente herramienta está expuesta a los clientes MCP:

get_livescores()

-> Devuelve información en tiempo real sobre los partidos de fútbol en curso en todo el mundo.

📝 Licencia