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: sleeper-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, 동일한 인터페이스