선수 통계, 다이너스티 가치, Sleeper 리그 데이터 및 사용자 정의 Excel 예측을 포함한 실시간 NFL 판타지 풋볼 분석 데이터를 AI 클라이언트에 제공합니다.
다른 이름 dachhack/stathead
- 스타
- 3
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 1.0.126
- 마지막 커밋
- 2026년 11월 15일
- 라이선스
- MIT
StatHead MCP란?
StatHead은(는) MCP server입니다. 선수 통계, 다이너스티 가치, Sleeper 리그 데이터 및 사용자 정의 Excel 예측을 포함한 실시간 NFL 판타지 풋볼 분석 데이터를 AI 클라이언트에 제공합니다.
프로젝트 README에서 생성된 요약
StatHead MCP server 정보
판타지 풋볼 팬과 분석가는 Claude Desktop, Cursor 또는 Claude Code와 같은 AI 클라이언트를 통해 실시간 NFL 데이터와 다이너스티 가치에 직접 접근할 수 있습니다. 이 MCP server는 선수 시즌 통계 및 스냅 카운트부터 고급 Next Gen Stats 및 부상 리포트에 이르기까지 모든 것을 다루는 50개 이상의 도구를 제공합니다. Sleeper 리그와 깊게 연결되어 있어 순위, 로스터, 트랜잭션은 물론 리그 간 매니저 노출도까지 확인할 수 있습니다.
사용자는 데이터를 Excel로 내보내고 수동으로 편집한 뒤 파일을 다시 가져오는 방식으로 자신만의 커스텀 랭킹과 예측을 관리하여 서버의 내부 모델을 오버라이드할 수 있습니다. stdio를 통한 npx 로컬 실행이나 호스팅된 URL을 통한 원격 커넥터 사용 등 설정 방법이 매우 간단합니다. 대부분의 데이터는 nflverse 및 Sleeper와 같은 공개 업스트림에서 가져오지만, 배당률과 같은 특정 기능은 외부 API 키가 필요합니다.
활용 사례
- 1Sleeper 리그 활동 분석AI에게 특정 Sleeper 리그 내의 최근 트레이드 및 웨이버 와이어 움직임을 검토하도록 요청합니다.
- 2다이너스티 트레이드 가치 평가과거 Sleeper 트레이드 데이터와 미래 예측을 사용하여 선수의 공정 시장 가치를 결정합니다.
- 3주간 매치업 난이도 평가실점 허용 데이터를 기반으로 다가오는 일정 중 어떤 선수가 가장 쉬운 대진을 가졌는지 식별합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
StatHead MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 StatHead MCP 설치
$ claude mcp add stathead-mcp -- npx -y stathead-mcpCursor에 StatHead MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"stathead-mcp": {
"command": "npx",
"args": [
"-y",
"stathead-mcp"
]
}
}
}VS Code에 StatHead MCP 설치
.vscode/mcp.json
{
"servers": {
"stathead-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"stathead-mcp"
]
}
}
}VS Code CLI에 StatHead MCP 설치
$ code --add-mcp '{"name":"stathead-mcp","type":"stdio","command":"npx","args":["-y","stathead-mcp"]}'Claude Desktop에 StatHead MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"stathead-mcp": {
"command": "npx",
"args": [
"-y",
"stathead-mcp"
]
}
}
}Codex에 StatHead MCP 설치
$ codex mcp add stathead-mcp -- npx -y stathead-mcpCodex config.toml에 StatHead MCP 설치
~/.codex/config.toml
[mcp_servers.stathead-mcp] command = "npx" args = ["-y", "stathead-mcp"]
Gemini CLI에 StatHead MCP 설치
$ gemini mcp add -s user stathead-mcp npx -- -y stathead-mcpGemini settings.json에 StatHead MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"stathead-mcp": {
"command": "npx",
"args": [
"-y",
"stathead-mcp"
]
}
}
}자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능dachhack/stathead is public and reachablegithub.com/dachhack/stathead ↗통과
- 패키지가 이 저장소를 소스로 명시stathead-mcp names dachhack/stathead as sourcenpmjs.com/package/stathead-mcp ↗통과
- 빌드 출처(Sigstore 증명)Sigstore attestation for stathead-mcpnpmjs.com/package/stathead-mcp/v/1.0.126#provenance ↗통과
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-12github.com/dachhack/stathead ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from stathead-mcp통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음1 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기stathead-mcp
An MCP server that exposes StatHead's NFL fantasy-analytics toolset to Claude (Desktop / Code), Cursor, or any MCP client — so you can ask natural-language questions and get live, structured NFL data back.
It ships as a single self-contained bundle with no runtime dependencies and
fetches all data on demand, so there's nothing to download or build — npx and
go.
What you get
50 tools spanning player and team data, including:
| Area | Tools |
|---|---|
| Discovery | get_metadata — sources, season coverage, and valid enums (call this first to scope a question) |
| Players | season stats, weekly/game logs, snap counts, injuries, advanced stats, Next Gen Stats, rosters, contracts, get_depth_charts (slot-aware team depth charts with roster status, StatHead depth order and view=changes for moves) |
| Games & plays | schedules/results, play-by-play, participation, FTN charting |
| Fantasy | StatHead blended dynasty values, get_trade_values (StatHead values fitted to millions of completed Sleeper dynasty trades: as-of weekly values with 90% ranges, movers, liquidity, scoring re-pricing, 1/3/6/12-month forecasts, rookie-pick classes and history), get_projections (StatHead's in-house season PPG model), get_weekly_projections (per-week matchup-adjusted points, weeks 1–18), get_matchups (weekly strength of matchup: fantasy points each defense allows per game to QB/RB/WR/TE, ranked 1–32 in your scoring and over expected, by week, per player, rest of schedule, or split by metric such as TE receptions or QB rushing), ADP (FFC / ESPN / Sleeper), get_adp_with_results (ADP vs actual finish), trending adds/drops |
| Sleeper leagues | get_sleeper_user_leagues, get_sleeper_league (standings + rosters), get_sleeper_league_users (cheap manager list), get_sleeper_matchups, get_sleeper_transactions (trades/waivers/adds), get_sleeper_waiver_wire (free agents × trending × projections), get_sleeper_draft, get_sleeper_user_snooper (cross-league exposure), get_sleeper_user_history (multi-season records + titles) — a connected graph: a username lists leagues, a league name (or id) opens that league, and each manager's owner_id/display name walks back to their leagues, exposure, and history |
| Draft & college | get_prospect_outcomes (calibrated boom/bust probabilities + grades), draft picks, get_rookie_class (draft+combine+rookie stats in one call), prospect profiles, combine, college stats (player or cohort), QBR |
| Model & methodology | get_model_docs (how the models work + per-position feature importance), get_player_features (why a player is scored the way they are — feature drivers, bands, direction) |
| Your own numbers | export_excel / import_excel / clear_overrides — download a styled projections / rankings / rookie-rankings workbook (or a by_team projection sheet with live PPR formulas), edit it, re-upload it, and have your values drive every later query |
Bring your own projections & rankings
The same boards the website lets you download are available over MCP as real
.xlsx files (built with zero extra dependencies — Node's own zlib):
export_excel kind="projections"(orrankings,rookie_rankings) writes a styled workbook to disk and returns its path. Edit the highlighted column — Proj PPG for projections, My Rank for rankings/rookies — in Excel or Google Sheets.import_excel path="…"reads it back and saves your values as overrides.get_projections,get_fantasy_rankings, andget_prospect_outcomesthen automatically use your numbers (flagged in the output) until you runclear_overrides.
Workbooks default to $STATHEAD_DIR (or the current working directory); pass
path to choose where they land. Overrides persist in
$STATHEAD_DIR/~/.stathead/overrides.json.
Quick start
Run it directly — no install, no clone:
npx -y stathead-mcp
It speaks MCP over stdio, so you normally wire it into a client rather than run it by hand.
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json
(macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"stathead": {
"command": "npx",
"args": ["-y", "stathead-mcp"]
}
}
}
Claude Code
claude mcp add stathead -- npx -y stathead-mcp
Cursor / other MCP clients
Use the same command/args (npx -y stathead-mcp) in the client's MCP
config.
Claude mobile apps / claude.ai web / Claude Desktop (remote connector)
Prefer a URL over a local command? The same tools are hosted over MCP's
Streamable HTTP transport by a Cloudflare Worker (workers/stathead-mcp/,
deployed via deploy-workers.yml):
https://stathead-mcp.dachhack.workers.dev
Add it under Settings → Connectors → Add custom connector, paste the URL,
and save — no command, no API key. (A GET to that URL returns a small health
payload; clients POST JSON-RPC to it.) The npm/stdio package above stays the
path for Claude Code and Cursor.
The Worker records a privacy-respecting usage counter (MCP method + tool name
only — no IPs or request bodies) to a Cloudflare Analytics Engine dataset
(stathead_mcp_usage). View aggregates at GET /stats once you set the
CF_ACCOUNT_ID + CF_ANALYTICS_TOKEN worker secrets (wrangler secret put …),
or query the dataset in the Cloudflare dashboard. npm download counts don't see
remote-connector usage — this does.
Data sources & freshness
Most tools fetch live from open upstreams (nflverse, Sleeper, FantasyFootballCalculator, ESPN's public endpoints). A handful read committed daily snapshots (StatHead's blended dynasty values, ADP history, in-house season projections), which the server fetches from the hosted StatHead site by default.
Please review DATA_SOURCES.md before redistributing
any data this server returns — several upstreams are proprietary or paid and
carry their own terms.
Configuration
All optional, via environment variables:
| Var | Default | Purpose |
|---|---|---|
STATHEAD_DATA_BASE |
GitHub raw (data branch) | Base URL for committed snapshot data (<base>data/<file>). Defaults to GitHub raw, which serves every file uncompressed/reliably (the Cloudflare host gzips files over its 25 MiB cap, which Node can't decode). Override to point at your own deployment or a local http://localhost:5173/ dev server. |
VITE_KTC_PROXY |
project worker | CORS proxy for KeepTradeCut. Deploy your own (workers/ktc-proxy) to avoid shared rate limits. |
VITE_FC_PROXY |
project worker | CORS proxy for FantasyCalc (workers/fc-proxy). |
VITE_ODDS_API_KEY |
— | Enables betting-odds tools (the-odds-api.com). |
Running from a full repo checkout instead? The server reads snapshots straight
from local public/data/ and ignores STATHEAD_DATA_BASE.
Building from source
The bundle is produced from the StatHead monorepo:
# from the repo root
npm install
npm run build:mcp # → mcp/dist/server.mjs (esbuild, single file)
node mcp/dist/server.mjs
Publishing
Bump version in mcp/package.json and SERVER_VERSION in
mcp/dist/server.mjs (they must match), merge to the default branch, then
any one of:
git push -f origin <commit>:publish-mcp-now # branch-push trigger (works from Claude Code sessions)
git tag mcp-v1.2.3 && git push origin mcp-v1.2.3 # tag trigger
# or Actions → "Publish stathead-mcp to npm" → Run workflow
publish-mcp.yml refuses a version already on npm and a commit not yet on
the default branch, smoke-tests the bundle, publishes via npm Trusted
Publishing, then chains the MCP Registry publish. Manual fallback:
npm run build:mcp # repo root — refresh the bundle
cd mcp && npm publish --access public
The published tarball is just dist/server.mjs + this README (~220 KB).
Listing in the MCP Registry
server.json is the manifest for the official MCP Registry
(io.github.dachhack/stathead-mcp). After an npm publish, the
Publish to MCP Registry workflow (.github/workflows/publish-mcp-registry.yml)
pushes it — authenticating via GitHub OIDC for the io.github.dachhack/*
namespace (no secret). The npm package carries a matching mcpName field so the
registry can verify the package belongs to this entry, and the workflow syncs
server.json's version from package.json so they never drift.
Most community directories (Glama, mcp.so, PulseMCP) mirror the official
registry and/or auto-index public npm packages with the model-context-protocol
keyword (which package.json has), so a registry publish propagates to them.
License
MIT — see ../LICENSE. The code is MIT; the data it returns
is not necessarily redistributable. See
DATA_SOURCES.md.
StatHead MCP 질문
StatHead MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add stathead-mcp -- npx -y stathead-mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
StatHead MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
자신만의 예측 및 랭킹을 어떻게 사용하나요?
예측 또는 랭킹을 Excel 파일로 내보낸 후, Excel이나 Google Sheets에서 값을 수정하고 파일을 다시 가져오면 해당 값을 쿼리 시 오버라이드 값으로 사용할 수 있습니다.
이 서버를 실행하는 데 필요한 런타임 종속성이 있나요?
아니요, 모든 데이터를 요청 시에 가져오는 단일 독립형 번들로 구성되어 있어 별도의 런타임 종속성이 없습니다.
Claude Desktop에서 사용할 수 있나요?
네, npx를 사용하여 서버를 실행하도록 Claude Desktop 설정 파일에 추가할 수 있습니다.
로컬 명령 대신 URL을 통해 도구에 어떻게 접근하나요?
도구는 Cloudflare Worker를 통해 MCP의 streamable HTTP 전송 방식으로 호스팅되며, 이를 Claude의 커스텀 커넥터로 추가할 수 있습니다.