Football Live MCP

Remote-MCP-Server, der Live-Fußballdaten von API-Football über HTTP bereitstellt und JSON-RPC 2.0 direkt ohne MCP-SDK implementiert.

Begleitprojekt zum lokalen Football Intelligence MCP-Server: Dieser dient der aktuellen Saison, während der lokale die historische Datenbank (2010–2025) in PostgreSQL bedient.

Protokoll

Transport: HTTP. Ein einziger Endpunkt, eine JSON-RPC-Nachricht pro Anfrage.

Implementierte Methoden: initialize, notifications/initialized, ping, tools/list, tools/call.

Protokollversion: 2025-06-18.

Tools

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

Lokal ausführen

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

Überprüfen:

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"}'

Auf Render bereitstellen

1. Übertrage dieses Verzeichnis in ein GitHub-Repository.

2. Erstelle in Render einen New Web Service und verbinde dieses Repository.

3. Render liest render.yaml; bestätige die Python-Laufzeit und den kostenlosen Plan.

4. Füge die Umgebungsvariable API_FOOTBALL_KEY mit deinem API-Football-Schlüssel hinzu.

5. Stelle bereit. Der öffentliche Endpunkt lautet https://<service>.onrender.com/mcp.

Der kostenlose Plan versetzt den Dienst nach Inaktivität in den Ruhezustand, daher dauert die erste Anfrage nach einer Pause etwa 50 Sekunden. Rufe GET / einmal vor einer Live-Demo auf, um ihn aufzuwecken.

Verwendung über einen MCP-Host

Füge der Host-Konfiguration einen Eintrag mit einem url-Feld hinzu:

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