Sleeper Draft Assistant MCP

픽 클록이 돌아가는 동안 ChatGPT에 최신 리그 인지형 Sleeper 드래프트 스냅샷을 제공하는 읽기 전용 프로토타입입니다.

이 서버는 하나의 집중된 Streamable HTTP MCP 도구인 get_live_draft_context를 노출합니다. 호출할 때마다 드래프트, 픽, 거래된 픽, 리그, 로스터, 리그 사용자를 새로고침합니다. 반환 내용:

• 매니저의 드래프트된 선수, 포지션 수, 채워진/비어 있는 스타터 슬롯, 벤치 공간;

• 현재 선택, 픽 진행 중인 매니저, 다음 선택까지 남은 픽 수;

• 리그 스코어링, 로스터, 드래프트 설정;

• 전체 드래프트 기록과 다른 모든 로스터의 간결한 포지션 요약;

• 현재 로스터 포지션별 미드래프트 선수.

Sleeper 선수 메타데이터는 /players/nfl이 크고 느리게 변하는 카탈로그이므로 24시간 동안 캐시됩니다. 가용성은 여전히 호출할 때마다 새로 가져온 픽에서 계산됩니다. 반환되는 sleeper_search_rank는 드래프트 조언이 아닌 발견용 메타데이터이며, 별도의 랭킹 또는 리서치 소스와 함께 사용해야 합니다.

로컬 실행

요구 사항: Node.js 22 이상.

npm install
cp .env.example .env
npm run dev

선택적으로 SLEEPER_USER_ID를 Sleeper 사용자 이름 또는 사용자 ID로 설정할 수 있습니다. 설정하지 않으면 MCP 호출에서 user를 제공해야 합니다.

엔드포인트:

• POST /mcp — 상태 비저장 Streamable HTTP MCP

• GET /health — 프로세스 상태

• GET / — 서비스 메타데이터

프로토타입 검증

npm test
npm run test:integration
npm run typecheck
npm run build
npx @modelcontextprotocol/inspector@latest

MCP Inspector를 http://localhost:3000/mcp에 연결하고, 도구를 나열한 다음, 실제 draft_id와 user로 get_live_draft_context를 호출하세요.

포함된 Dockerfile은 HTTPS를 지원하는 모든 컨테이너 호스트용 프로덕션 이미지를 빌드합니다:

docker build -t sleeper-mcp .
docker run --rm -p 3000:3000 -e SLEEPER_USER_ID=your-user sleeper-mcp

ChatGPT의 경우 공개 HTTPS 또는 지원되는 보안 터널을 통해 엔드포인트를 노출하세요. 그런 다음 설정 → 보안 및 로그인에서 개발자 모드를 활성화하고, ChatGPT 플러그인에서 MCP 서버를 추가한 다음, /mcp를 포함한 HTTPS URL을 입력하세요. 새 채팅을 시작하고, 도구 메뉴에서 연결을 추가한 다음, 모바일 앱에서 드래프트 질문을 하세요.

보안 터널을 사용할 때는 기본 localhost 바인딩을 유지하세요. 서버를 의도적으로 노출하는 경우 HOST=0.0.0.0을 설정하고, 클라이언트가 bearer 자격 증명을 보낼 수 있을 때 MCP_BEARER_TOKEN을 구성하고, TLS는 호스팅 엣지에 배치하세요. 브라우저 발신 요청은 정확한 출처가 MCP_ALLOWED_ORIGINS에 나타나지 않으면 거부됩니다. 서버 간 MCP 요청은 일반적으로 Origin을 생략합니다.

프로토타입 경계

• 읽기 전용: Sleeper 선택을 하거나 리그를 수정하는 코드 경로가 없습니다.

• 랭킹 엔진 없음: 외부 랭킹, 예측, 부상 리서치, 뉴스는 별도로 유지됩니다.

• 스네이크/선형 드래프트: 현재 및 향후 픽 계산은 거래된 픽을 포함한 이러한 형식을 지원합니다. 옥션 입찰 순서는 지원되지 않는 것으로 보고됩니다.

• 공개 Sleeper 데이터: 선택적 bearer 토큰은 엔드포인트를 보호하지만 사용자별 인증은 아닙니다. 개인 증명에는 보안 터널을 사용하고 공유 서비스로 운영하기 전에 OAuth를 추가하세요.

• 가용성은 Sleeper 선수 카탈로그에 따라 달라집니다. 유한한 양수 search_rank가 없는 선수는 간결한 후보 목록에서 제외되지만, 선택 시 드래프트 기록에는 계속 표시됩니다.

환경 변수

소스 참조

• Sleeper의 API 문서는 인증되지 않은 읽기 전용 엔드포인트와 사용량 제한을 설명합니다.

• OpenAI의 MCP 서버 가이드는 도구 스키마, 주석, 결과, TypeScript SDK를 다룹니다.

• OpenAI의 연결 가이드는 공개 HTTPS 또는 보안 터널, MCP Inspector, 개발자 모드, ChatGPT에 /mcp 엔드포인트 추가를 다룹니다.