Liga Record MCP

Ein MCP-Server, der meinen Liga Record Fantasy-Fußball-Kader für Claude bereitstellt – die Regeln als Tools, das Reglement als Ressource und zwei Prompts für die Entscheidungen, die ich tatsächlich jede Runde treffe.

Die Aufteilung, auf der er beruht: deterministische Regeln leben im Code, das Urteilsvermögen bleibt bei Claude. Formationszulässigkeit, Budget-Arithmetik und die automatischen Auswechslungen nach §11 werden hier berechnet und sind maßgeblich. Wen man aufstellt und wen man verkauft, darüber soll Claude nachdenken – mit echten Daten und dem echten Regelwerk.

Siehe docs/PLANNING.md für das Design und die Regel-Mehrdeutigkeiten, die diese Lesart des Reglements offen lässt.

Einrichtung

python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e .

Die editierbare Installation ist nicht optional – sie sorgt dafür, dass liga_record_mcp im Pfad liegt (das Projekt verwendet ein src/-Layout) und erstellt den liga-record-mcp-Launcher, auf den die MCP-Konfiguration zeigt.

Dein Kader befindet sich in data/squad.yaml. Kopiere data/squad.example.yaml und fülle deine 23 Spieler ein – der Loader prüft die Datei bei jedem Einlesen gegen das Reglement und benennt, was fehlt, damit du nicht von Hand zählen musst. Setze LIGA_RECORD_SQUAD auf eine andere Datei, um ein zweites Team zu verwalten.

Related MCP server: wcprediction-mcp

Anbindung an Claude

.mcp.json im Repository-Stammverzeichnis deklariert den Server bereits, sodass Claude Code ihn automatisch erkennt, wenn du dieses Projekt öffnest – kein CLI nötig. Starte Claude Code nach der Installation neu und genehmige den Server, wenn du dazu aufgefordert wirst.

Der Pfad in .mcp.json ist absolut und maschinenspezifisch. Windows löst einen relativen Befehl relativ zum Verzeichnis des startenden Prozesses auf, nicht zu dem des Servers, sodass ein relativer Pfad fehlschlägt, wenn die App ihn startet. Bearbeite diesen Pfad, wenn du das Repository verschiebst oder klonst.

Claude Desktop verwendet dieselbe Struktur in claude_desktop_config.json:

{
  "mcpServers": {
    "liga-record": {
      "command": "C:\\path\\to\\liga-record-mcp\\.venv\\Scripts\\liga-record-mcp.exe"
    }
  }
}

Dann frag ihn etwas: "Ist meine aktuelle Startelf regelkonform, und wer kommt rein, wenn Diogo Costa nicht spielt?"

Was es bereitstellt

Tools — get_squad, get_player, search_squad, validate_selection, simulate_autosubs, check_transfer, project_price, plus zwei, die die Live-Website lesen: search_market (der gesamte Spielerpool mit Besitzquoten, um Differenzialspieler zu finden) und check_market_transfer (kalkuliert einen Tausch anhand des echten Kurses statt einer manuell eingegebenen Angabe). Jeder Lesevorgang trägt einen as_of-Zeitstempel, damit Claude sagen kann, wie aktuell die Daten sind, anstatt einen gespeicherten Kader als live darzustellen.

Der Live-Client ist konstruktionsbedingt schreibgeschützt. Die Website bietet außerdem Kauf-, Verkaufs- und Neuverhandlungs-Endpunkte – deren Verträge bekannt sind – und sie sind bewusst nicht implementiert. Das Bestätigen eines Transfers bleibt ein menschlicher Klick auf der Website von Record.

Ressourcen — ligarecord://regulamento (aus denselben Konstanten generiert, die den Regeln zugrunde liegen, sodass es nicht vom Code abweichen kann) und ligarecord://squad.

Prompts — pick_starting_xi, plan_transfers.

Tests

./.venv/Scripts/python.exe -m pytest -q

rules.py ist rein – kein I/O, kein Netzwerk, keine Uhr – sodass das gesamte Regelwerk getestet wird, ohne die Website zu berühren.

Status

Schritte 1–3 sind abgeschlossen: die Regel-Engine, die Datenquellen-Nahtstelle mit einem manuell gepflegten YAML-Kader und der MCP-Server.

Schritt 4 ist zur Hälfte erledigt, und die Hälfte, die am meisten zählt, ist die, die ausgeliefert wurde. playersearch.ashx liefert sauberes JSON für den gesamten Markt mit 498 Spielern und benötigt keine Authentifizierung – verifiziert mit einer Anfrage ohne Cookie –, sodass das Session-Token-Problem, das der Plan als Hauptrisiko von Schritt 4 einstufte, für Marktdaten schlicht nicht auftritt.

Das Lesen des Kaders eines bestimmten Teams erfordert weiterhin einen Login, daher bleibt data/squad.yaml manuell gepflegt. Das ist der verbleibende Teil.