Sleeper MCP

Ein schreibgeschützter Model Context Protocol-Server für die öffentliche Sleeper API. Er stellt Benutzer, Ligen, Kader, Begegnungen, Transaktionen, Drafts, Spieler, Trendaktivitäten, Playoff-Brackets, gehandelte Picks und den Sportstatus über asynchrone FastMCP-Tools bereit.

Sleeper erfordert keinen API-Schlüssel. Bitte beachte die dokumentierten Hinweise, um unter 1.000 Anfragen pro Minute zu bleiben. Die vollständige Antwort mit den Spielerdaten ist mehrere Megabyte groß und sollte in der Regel höchstens einmal pro Tag abgerufen werden.

Installation

Erfordert Python 3.11 oder neuer und uv.

uv sync

Related MCP server: flaim

Ausführen

Der Server verwendet standardmäßig den stdio-Transport von MCP:

uv run sleeper-mcp

Das entsprechende Modulkommando lautet:

uv run python -m sleeper_mcp.server

Docker

Das Image basiert auf alpine:latest und führt den MCP-Server über stdio aus. Behalte -i bei, damit der Client über stdin mit dem Prozess kommunizieren kann.

docker build -t sleeper-mcp .
docker run --rm -i sleeper-mcp

Cursor (Docker)

{
  "mcpServers": {
    "sleeper": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "sleeper-mcp"
      ]
    }
  }
}

Claude Desktop (Docker)

{
  "mcpServers": {
    "sleeper": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "sleeper-mcp"
      ]
    }
  }
}

MCP-Client konfigurieren

Verwende den absoluten Pfad des Arbeitsbereichs in deiner Client-Konfiguration (oder die Docker-Befehle oben).

Cursor

Füge diesen Server zu deiner Cursor-MCP-Konfiguration hinzu:

{
  "mcpServers": {
    "sleeper": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/talweiss/Desktop/codeProjects/sleeper-mcp",
        "run",
        "sleeper-mcp"
      ]
    }
  }
}

Claude Desktop

Füge denselben Eintrag unter mcpServers in der Konfiguration von Claude Desktop hinzu:

{
  "mcpServers": {
    "sleeper": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/talweiss/Desktop/codeProjects/sleeper-mcp",
        "run",
        "sleeper-mcp"
      ]
    }
  }
}

Starte den Client neu, nachdem du seine Konfiguration geändert hast.

Entwicklung

uv run pytest

Das Paket folgt einem Schichtenaufbau:

• client.py kümmert sich um HTTP-Belange und die Sleeper-Basis-URL.

• service.py ordnet Methoden den dokumentierten API-Endpunkten zu.

• tools.py dokumentiert und stellt Servicemethoden als MCP-Tools bereit.

• server.py verbindet die Schichten miteinander und startet FastMCP.