cfbd-mcp-server

MCP-Server für College-Football-Daten

Eine MCP-Serverimplementierung, die Zugriff auf College-Football-Statistiken bietet, die aus der College Football Data API V2 in Claude Desktop stammen.

Überblick

Dieser Model Context Protocol (MCP)-Server ermöglicht KI-Assistenten und -Anwendungen:

Abfrage umfassender Statistiken und Daten zum College-Football
Zugriff auf Spielergebnisse, Mannschaftsrekorde und Spielerstatistiken
Analysieren Sie Spieldaten und Laufwerkszusammenfassungen
Sehen Sie sich Ranglisten und Gewinnwahrscheinlichkeitsmetriken an
Vergleichen Sie die Teamleistungen und gewinnen Sie Erkenntnisse

Benutzer können Abfragen in natürlicher Sprache ausführen.

Beispielausgabe

F: Was war die größte Überraschung bei den FCS-Spielen während der Saison 2014?

A. Ich möchte Ihnen helfen, die größte FCS-Überraschung des Jahres 2014 zu finden. Ich werde die Spieldaten durchsehen und mich auf Spiele zwischen FCS-Teams konzentrieren, bei denen es einen erheblichen Unterschied in der Teamstärke und ein unerwartetes Ergebnis gab.

Die Daten deuten darauf hin, dass es 2014 in der FCS mehrere bemerkenswerte Überraschungen gab. Besonders hervorzuheben ist jedoch der 52:59-Sieg von Eastern Washington am 6. September 2014. Dies war aus folgenden Gründen besonders bedeutsam:

Washington war ein FBS-Team aus der Pac-12-Konferenz
Das Spiel wurde im Heimstadion von Washington (Husky Stadium) ausgetragen.
Die Gewinnwahrscheinlichkeit von Eastern Washington lag laut den Statistiken nach dem Spiel bei nur 1,4 %
Die 59 Punkte, die Eastern Washington erzielte, waren die meisten, die ein FCS-Team jemals gegen einen Pac-12-Gegner erzielte
Washington war aufgrund mehrerer Punkte im Vorfeld des Spiels favorisiert

Zu den weiteren bemerkenswerten FCS-Überraschungen dieser Saison gehörten:

North Dakota State besiegt Iowa State mit 34:14
Bethune-Cookman besiegt FIU 14-12
Northern Iowa hätte Iowa beinahe geschlagen (31-23 verloren)

Allerdings scheint der Sieg von Eastern Washington über Washington die größte Überraschung der FCS-Saison 2014 zu sein, wenn man Folgendes berücksichtigt:

Der Unterschied in den Divisionen (FCS vs. FBS)
Das Kaliber des FBS-Gegners (Power 5-Konferenz)
Der Torvorsprung und die Offensivleistung des Außenseiters
Die historische Bedeutung als einer der FCS-Siege mit den höchsten Punktzahlen gegen ein Power 5-Team
Die Tatsache, dass es auf der Straße in einer feindlichen Umgebung passiert ist

Voraussetzungen

Python 3.11 oder höher
UV-Paketmanager (empfohlen)
Ein College Football Data API-Schlüssel ( hier erhalten )

Installation

Installation über Smithery

So installieren Sie College Football Data Server für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install cfbd --client claude

Klonen Sie dieses Repository:

git clone https://github.com/yourusername/cfbd-mcp-server
cd cfbd-mcp-server

Erstellen und aktivieren Sie eine virtuelle Umgebung:

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

Installieren Sie Abhängigkeiten:

uv pip install -e .

Erstellen Sie eine .env Datei im Projektstamm und fügen Sie Ihren API-Schlüssel hinzu:

CFB_API_KEY=your_api_key_here

Manuelle Installation

Klonen Sie dieses Repository:

git clone https://github.com/yourusername/cfbd-mcp-server
cd cfbd-mcp-server

Erstellen und aktivieren Sie eine virtuelle Umgebung:

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

Installieren Sie Abhängigkeiten:

uv pip install -e .

Erstellen Sie eine .env Datei im Projektstamm und fügen Sie Ihren API-Schlüssel hinzu:

CFB_API_KEY=your_api_key_here

Verwendung

Ausführen des Servers

Starten Sie den Server:

uv run cfbd-mcp-server

Verbindung mit Claude Desktop herstellen

Öffnen Sie Ihre Claude Desktop-Konfiguration unter:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Fügen Sie die Serverkonfiguration hinzu:

{
    "mcpServers": {
        "cfbd-mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "/full/path/to/cfbd-mcp-server",
                "run",
                "cfbd-mcp-server"
            ],
            "env": {
                "CFB_API_KEY": "xxx",
                "PATH": "/full/path/to/python"
            }
        }
    }
}

Schließen Sie Claude Desktop und starten Sie es neu.

Nach dem Neustart können Sie die Installation durch Klicken auf das Pluszeichen in der unteren linken Ecke des Textfelds bestätigen. Bei erfolgreicher Installation wird „Vom cfbd-mcp-Server hinzufügen“ als eine der Menüoptionen angezeigt. Hier ist ein Beispiel-Screenshot.

Aktualisierung nach der Installation

Laden Sie die aktualisierten Dateien herunter

cd cfbd-mcp-server
git pull

Deinstallieren Sie das vorhandene Paket:

uv pip uninstall cfbd-mcp-server

Löschen vorhandener Build-Artefakte und Metadaten

Für Windows:

rmdir /s /q build dist
del /s /q *.egg-info

Für macOS:

rm -rf build dist *.egg-info

Installieren Sie das überarbeitete Paket und seine Abhängigkeiten

uv pip install -e .
uv sync --dev --all-extras

uv run cfbd-mcp-server

Schließen und starten Sie Claude Desktop neu

Merkmale

Ressourcen

Zugriffsschemadokumentation für alle Endpunkte:

schema://games – Spielinformationen und Spielstände
schema://records - Saisonrekorde der Teams
schema://games/teams – Detaillierte Teamspieldaten
schema://plays – Spiel-für-Spiel-Informationen
schema://drives - Laufwerkszusammenfassungen und Ergebnisse
schema://play/stats – Individuelle Spielstatistiken
schema://rankings – Team-Rankings aus Umfragen
schema://metrics/wp/pregame – Gewinnwahrscheinlichkeiten vor dem Spiel
schema://game/box/advanced – Erweiterte Boxscore-Statistiken

Werkzeuge

Endpunkte direkt abfragen:

get-games - Spieldaten abrufen
get-records - Teamrekorde abrufen
get-games-teams – Zugriff auf Team-Spielstatistiken
get-plays - Spieldaten einzeln abfragen
get-drives - Laufwerksinformationen analysieren
get-play-stats - Spielstatistiken anzeigen
get-rankings - Team-Ranglisten prüfen
get-pregame-win-probability – Gewinnwahrscheinlichkeiten anzeigen
get-advanced-box-score - Zugriff auf detaillierte Spielstatistiken und Analysen

Eingabeaufforderungen

Vorgefertigte Analysevorlagen:

analyze-game - Erhalten Sie eine detaillierte Analyse eines bestimmten Spiels
analyze-team - Umfassende Einzelteamanalyse
analyze-trends - Trends über eine Saison hinweg analysieren
compare-teams - Vergleichen Sie die Leistung zweier Teams
analyze-rivalry - Analysieren Sie historische Rivalitätspaarungen

API-Grenzen

Die Nutzung der College Football Data API ist kostenlos, unterliegt jedoch einer Ratenbegrenzung:

Kostenlose Stufe: Begrenzte Anfragen pro Minute
CFBD Patreon-Abonnenten erhalten höhere Ratenlimits
Verwenden Sie effiziente Abfragemuster, um das Erreichen von Grenzen zu vermeiden
Behandeln Sie Ratenbegrenzungsfehler ordnungsgemäß

Entwicklung

Projektstruktur

cfbd-mcp-server/
├── README.md
├── pyproject.toml
└── src/
    └── cfbd_mcp_server/
        ├── .env
        ├── __init__.py
        ├── cfbd_schema.py
        ├── schema_helpers.py
        └── server.py

Vorbereitungen für die Entwicklung

Klonen Sie das Repository
Installieren Sie Entwicklungsabhängigkeiten:

uv pip install -e ".[dev]"

Führen Sie Tests durch:

pytest

Beitragen

Forken Sie das Repository
Erstellen eines Feature-Zweigs
Übernehmen Sie Ihre Änderungen
Drücken Sie zu Ihrer Gabel
Senden einer Pull-Anfrage

Fehlerbehebung

Häufige Probleme

API-Schlüsselfehler
- Überprüfen Sie, ob Ihr API-Schlüssel in den Dateien .env und claude_desktop_config.json korrekt festgelegt ist.
- Überprüfen Sie unter collegefootballdata.com, ob der Schlüssel gültig ist
Ratenbegrenzung
- Verteilen Sie die Anfragen nach Möglichkeit zeitversetzt
- Erwägen Sie ein Patreon-Abonnement für höhere Limits
- Implementieren Sie Caching für häufig abgerufene Daten
Verbindungsprobleme
- Überprüfen der Internetverbindung
- Überprüfen Sie den API-Status unter collegefootballdata.com
- Sorgen Sie für eine ordnungsgemäße Fehlerbehandlung in Ihrem Code

Hilfe bekommen

Öffnen Sie ein Problem auf GitHub
Überprüfen Sie die API-Dokumentation
Überprüfen Sie den College Football Data Discord

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .

Danksagung

College Football Data zur Bereitstellung der API
Model Context Protocol für die MCP-Spezifikation