SleepBot

Claudeをファンタジーフットボールリーグに接続するMCPサーバー。フェーズ1: Sleeperの公開APIを使用した読み取り専用ツール（認証不要）。ツールインターフェースを変更せずに、書き込みアクション、ESPN、複数リーグに拡張できるように構築されています。

アーキテクチャ

コアはプラットフォームに依存しません。すべてのツールはLeagueAdapterインターフェースと通信し、プラットフォームSDKに直接アクセスすることはありません：

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

リーグやプラットフォームの追加は設定変更であり、コード変更ではありません。アーキテクチャはcairn.blueprint内でCairnを使用してマッピングされています。cairn scanを実行して、マップをコードと照合します。

Related MCP server: Yahoo Fantasy Baseball MCP

セットアップ

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

SleeperリーグIDは、アプリのURLまたは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" }
    }
  ]
}

シークレットはインラインで保存されることはありません。"env:ESPN_S2"のような値は、実行時に環境から解決されます（.env.exampleを参照）。フェーズ1ではシークレットは不要です。

実行

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

Claude Codeに登録

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

ツール（フェーズ1 — すべて読み取り専用）

すべてのツールはleagueIdラベルを受け取るため、マルチリーグ対応は「別のIDを渡す」だけです。設定でsleeper.usernameを設定すると、ロースター/順位/対戦がisYouでフラグ付けされ、SleepBotは尋ねることなくどのチームがあなたのものかを認識します。

npm testでテストを実行します。

ロードマップ

• フェーズ2 — Sleeperの書き込みアクション（デフォルトで確認）+ ルールエンジン（src/rules、スタブ）

• フェーズ3 — 同じツールを使用したローカルGUI（Vite/React）

• フェーズ4 — ESPNのクッキーベースAPIに対するEspnAdapter、同じインターフェース