NFL-Transaktionen MCP

Ein modulares Befehlszeilenprogramm (MCP) zum Scrapen von NFL-Transaktionsdaten von ProSportsTransactions.com.

Merkmale

Rufen Sie NFL-Transaktionen mit flexiblen Filteroptionen ab:
- Spieler-/Trainer-/Führungskräftebewegungen (Trades, Verpflichtung von Free Agents, Draftpicks usw.)
- Bewegungen zur/von der Verletztenreserve
- Wechsel zu und aus Minor Leagues (NFL Europe)
- Verpasste Spiele wegen Verletzungen
- Verpasste Spiele aus persönlichen Gründen
- Disziplinarmaßnahmen (Suspendierungen, Geldstrafen usw.)
- Rechtliche/kriminelle Vorfälle
Filtern Sie nach Team, Spieler, Datumsbereich und Transaktionstyp
Ausgabedaten im CSV-, JSON- oder DataFrame-Format
Listen Sie alle NFL-Teams und Transaktionsarten auf

Installation

# Clone the repository
git clone <repository-url>
cd nfl_transactions_mcp

# Install requirements
pip install -r requirements.txt

Verwendung mit Cursor

Um dieses MCP mit Cursor zu verwenden, fügen Sie Ihrer Datei .cursor/mcp.json die folgende Konfiguration hinzu:

{
  "mcpServers": {
    "nfl-transactions": {
      "command": "python server.py",
      "env": {}
    }
  }
}

Direktes Ausführen des MCP

# Run the MCP server via Cursor
cursor run-mcp nfl-transactions

Verfügbare Tools

1. Transaktionen abrufen

Ruft NFL-Transaktionen basierend auf angegebenen Filtern ab.

Parameter:

start_date (erforderlich): Startdatum im Format JJJJ-MM-TT
end_date (erforderlich): Enddatum im Format JJJJ-MM-TT
transaction_type (optional, Standard: „Alle“): Zu filternder Transaktionstyp
team (optional): Teamname
player (optional): Spielername
output_format (optional, Standard: "json"): Ausgabeformat (csv, json oder Dataframe)

Beispiel:

{
  "jsonrpc": "2.0",
  "method": "fetch_transactions",
  "params": {
    "start_date": "2023-01-01",
    "end_date": "2023-12-31",
    "transaction_type": "Injury",
    "team": "Patriots"
  },
  "id": 1
}

2. list_teams

Listet alle zum Filtern verfügbaren NFL-Teams auf.

Beispiel:

{
  "jsonrpc": "2.0",
  "method": "list_teams",
  "id": 2
}

3. list_transaction_types

Listet alle zum Filtern verfügbaren Transaktionstypen auf.

Beispiel:

{
  "jsonrpc": "2.0",
  "method": "list_transaction_types",
  "id": 3
}

Integration mit Superagenten

Dieses MCP ist für die einfache Integration mit KI-Agenten oder Superagenten konzipiert. Ein Agent kann JSON-RPC-Anfragen stellen, um mit diesem MCP zu interagieren und NFL-Transaktionsdaten basierend auf Benutzeranfragen abzurufen.

Beispiel für eine Agentenintegration:

# Example of an agent calling the MCP
import json
import subprocess

def call_mcp(method, params=None):
    request = {
        "jsonrpc": "2.0",
        "method": method,
        "params": params or {},
        "id": 1
    }
    
    # Call the MCP via cursor
    cmd = ["cursor", "run-mcp", "nfl-transactions"]
    proc = subprocess.Popen(cmd, stdin=subprocess.PIPE, stdout=subprocess.PIPE, text=True)
    
    # Send the request and get the response
    response, _ = proc.communicate(json.dumps(request))
    return json.loads(response)

# Example: Get Patriots injury transactions from 2023
result = call_mcp("fetch_transactions", {
    "start_date": "2023-01-01",
    "end_date": "2023-12-31",
    "transaction_type": "Injury",
    "team": "Patriots"
})

print(f"Found {len(result['data'])} transactions")