SleepBot

Ein MCP-Server, der Claude mit Fantasy-Football-Ligen verbindet. Phase 1: Nur-Lese-Tools über die öffentliche Sleeper-API (keine Authentifizierung erforderlich). Entwickelt, um auf Schreibaktionen, ESPN und mehrere Ligen erweitert zu werden, ohne die Tool-Schnittstelle zu ändern.

Architektur

Der Kern ist plattformunabhängig. Jedes Tool spricht mit einer LeagueAdapter-Schnittstelle, nie direkt mit einem Plattform-SDK:

tools ──▶ LeagueAdapter (interface) ◀── SleeperAdapter ──▶ api.sleeper.app
  │                                       (EspnAdapter later)
  └──▶ config (leagues[] registry)

Das Hinzufügen einer Liga oder einer Plattform ist eine Konfigurationsänderung, keine Codeänderung. Die Architektur ist mit Cairn in cairn.blueprint abgebildet; führen Sie cairn scan aus, um die Abbildung mit dem Code abzugleichen.

Related MCP server: Yahoo Fantasy Baseball MCP

Einrichtung

npm install
cp config/leagues.example.json config/leagues.json   # then edit with your league
npm run build

Finden Sie Ihre Sleeper-Liga-ID in der App-URL oder über https://api.sleeper.app/v1/user/<username>/leagues/nfl/<season>.

config/leagues.json

{
  "leagues": [
    {
      "id": "my-main-league",        // your own label, passed to every tool
      "platform": "sleeper",         // "sleeper" | "espn"
      "sleeper": { "leagueId": "123456789012345678", "username": "yourusername" }
    }
  ]
}

Geheimnisse werden niemals inline gespeichert – ein Wert wie "env:ESPN_S2" wird zur Laufzeit aus der Umgebung aufgelöst (siehe .env.example). Phase 1 benötigt keine Geheimnisse.

Ausführen

npm start          # serves over stdio (built)
npm run dev        # serves over stdio (tsx, no build)

Bei Claude Code registrieren

// .mcp.json / claude mcp add
{
  "mcpServers": {
    "sleepbot": { "command": "node", "args": ["dist/index.js"] }
  }
}

Tools (Phase 1 – alle nur lesbar)

Jedes Tool akzeptiert Ihr leagueId-Label, sodass Multi-Liga-Unterstützung einfach „eine andere ID übergeben" ist. Setzen Sie sleeper.username in der Konfiguration, und Kader/Standings/Matchups werden mit isYou markiert, sodass SleepBot weiß, welches Team Ihnen gehört, ohne zu fragen.

Führen Sie die Tests mit npm test aus.

Roadmap

• Phase 2 – Sleeper-Schreibaktionen (Standard: Bestätigen) + Regeln-Engine (src/rules, Stub)

• Phase 3 – Lokale GUI (Vite/React) über dieselben Tools

• Phase 4 – EspnAdapter gegen die cookie-basierte API von ESPN, gleiche Schnittstelle