Sleeper Draft Assistant MCP

一个只读原型，在选秀时钟运行期间为 ChatGPT 提供最新的、感知联赛的 Sleeper 选秀快照。

该服务器暴露一个聚焦的 Streamable HTTP MCP 工具 get_live_draft_context。每次调用都会刷新选秀、选秀权、交易选秀权、联赛、阵容和联赛用户。它返回：

• 管理员的已选球员、位置数量、已填/空缺的首发位置以及替补空间；

• 当前选秀顺位、正在选秀的管理员，以及距离用户下一次选秀的选秀权数；

• 联赛计分、阵容和选秀设置；

• 完整的选秀历史和每个其他阵容的紧凑位置摘要；

• 按阵容位置分类的当前未选球员。

Sleeper 球员元数据会缓存 24 小时，因为 /players/nfl 是一个庞大且变化缓慢的目录。每次调用仍会根据最新获取的选秀权计算可用性。返回的 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、开发者模式以及将 /mcp 端点添加到 ChatGPT。