Football Live MCP

Servidor MCP remoto que expone datos de fútbol en vivo de API-Football a través de HTTP, implementando JSON-RPC 2.0 directamente sin ningún SDK de MCP.

Complemento del servidor local Football Intelligence MCP: este sirve la temporada actual, mientras que el local sirve la base de datos histórica (2010-2025) almacenada en PostgreSQL.

Protocolo

Transporte: HTTP. Un único endpoint, un mensaje JSON-RPC por solicitud.

Métodos implementados: initialize, notifications/initialized, ping, tools/list, tools/call.

Versión del protocolo: 2025-06-18.

Herramientas

Identificadores de liga: 39 Premier League, 140 La Liga, 135 Serie A, 78 Bundesliga, 61 Ligue 1, 94 Primeira Liga, 2 UEFA Champions League.

Ejecutar localmente

pip install -r requirements.txt
export API_FOOTBALL_KEY=your_key_here
python server.py                    # listens on :8080

Verificar:

curl http://localhost:8080/

curl -X POST http://localhost:8080/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Desplegar en Render

1. Sube este directorio a un repositorio de GitHub.

2. En Render, crea un New Web Service y conecta ese repositorio.

3. Render lee render.yaml; confirma el runtime de Python y el plan gratuito.

4. Añade la variable de entorno API_FOOTBALL_KEY con tu clave de API-Football.

5. Despliega. El endpoint público será https://<service>.onrender.com/mcp.

El plan gratuito suspende el servicio tras un periodo de inactividad, por lo que la primera solicitud después de una pausa tarda unos 50 segundos. Llama a GET / una vez antes de una demo en vivo para reactivarlo.

Uso desde un host MCP

Añade una entrada con un campo url a la configuración del host:

{
  "mcpServers": {
    "football_live": { "url": "https://<service>.onrender.com/mcp" }
  }
}