Datos de fútbol del MCP

⚽️ Servidor MCP de Soccerdata

MCP-Soccerdata es un servidor de Protocolo de Contexto de Modelo (MCP) de código abierto que se conecta a SoccerDataAPI para brindar información actualizada sobre partidos de fútbol a través de 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 modelos de lenguaje grandes (LLM).

✨ Características

🏟️ Análisis de partidos de fútbol en directo

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

¿Qué partidos de fútbol se están jugando ahora mismo?
"¿Cuáles son las alineaciones previstas para el PSG vs Aston Villa hoy?"
"Por favor, dígame los resultados y el número de goles de los últimos partidos de fútbol".

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

- Listados de partidos e información básica

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

- Detalles del partido

Estado del partido: programado, en progreso o finalizado
Desglose de goles: primera mitad, segunda mitad, prórroga, tanda de penaltis
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
Sanciones

- Alineaciones de los equipos

Once inicial
Jugadores de banca
Estado de la lesión
Formación del equipo

- Información sobre probabilidades y apuestas

Probabilidades de ganar/empatar/perder
Más/Menos probabilidades
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.

🎥 Demostración

🚀 Inicio rápido

Instalación mediante herrería

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

Prerrequisitos

Python 3.12+
administrador de paquetes uv
Cuenta API de Soccerdata
Cliente compatible con MCP (por ejemplo, Claude para escritorio)

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. Obtenga su clave API y configure el entorno

Crea un archivo .env con tus credenciales:

AUTH_KEY=your_auth_key

Regístrese en https://soccerdataapi.com/ y obtenga sus propias claves de autenticación.

3. Configurar el cliente MCP

Registre este servidor en su 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

Este proyecto está licenciado bajo la Licencia MIT . Consulte el archivo de LICENCIA para más detalles.
Construido con el Protocolo de Contexto de Modelo