沉睡梦幻足球MCP服务器
模型上下文协议（MCP）服务器，为联赛、名册、比赛、选秀、球员等提供对睡眠者梦幻足球API的全面访问。
目的
此MCP服务器为AI助理提供了一个安全的接口，以访问Sleeper Fantasy Football数据，包括联赛信息、名单、比赛、季后赛括号、交易、选秀数据和球员统计数据。
特性
当前实施情况
get_user-通过用户名或用户ID获取用户信息get_user_leagues-获取特定运动和赛季中用户的所有联赛get_league-获取特定联赛的详细信息get_league_rosters-获取联盟中的所有名单，包括排名和球员信息get_league_users-获取联盟中所有用户的球队信息get_league_matchups-获取联盟中特定一周的所有比赛get_winners_bracket-获得联盟季后赛冠军get_losers_bracket-获得联盟季后赛失败者的排名get_league_transactions-获取特定一周的所有交易，包括交易、豁免和自由球员提货get_traded_picks-获取联盟中所有交易的选秀权，包括未来的选秀权get_nfl_state-获取当前NFL赛季状态，包括周、赛季类型和赛季日期get_user_drafts-获取特定运动和季节中用户的所有草稿get_league_drafts-获取联赛的所有选秀权get_draft-获取特定草稿的详细信息get_draft_picks-在草稿中做出所有选择get_draft_traded_picks-在选秀中获得所有交易的选秀权get_trending_players-根据添加或删除活动获取热门玩家search_player_info-按玩家ID搜索特定玩家的详细信息
先决条件
- 启用MCP工具包的Docker桌面
- Docker MCP CLI插件(
docker mcp命令） - 无需API认证（轨枕API为只读和公共）
安装
请参阅随文件提供的分步说明。
配置
您可以选择将默认联赛ID设置为环境变量：
SLEEPER_LEAGUE_ID-您的默认联盟ID（例如，“1257057278398300160”）
如果设置了，当没有提供任何联赛ID时，工具将使用此ID作为默认联赛ID。
用法示例
在Claude Desktop中，您可以问：
联盟信息
- “显示我的Sleeper联赛的详细信息1257057278398300160”
- “我目前的联赛排名是多少？”
- “我幻想联盟中的所有用户都是谁？”
配对与得分
- “给我看看我联赛第5周的比赛”
- “本周比赛的比分是多少？”
名册和球员
- “给我看看我联盟中的所有名单”
- “在过去24小时内添加热门玩家”
- “搜索玩家ID 4866的玩家信息”
季后赛
- “给我看看季后赛支架”
- “失败者群体是什么样子的？”
交易
- “显示第3周的所有交易和豁免提货”
- “在我的联盟中交易了哪些选秀权？”
草稿
- “向我展示我的联盟的初步结果”
- “从草稿ID 12345678中获取所有选择”
NFL信息
- “我们在NFL赛季的哪一周？”
- “了解当前的NFL状态”
建筑
Claude Desktop → MCP Gateway → Sleeper MCP Server → Sleeper API
(api.sleeper.app)发展
局部测试
# Set environment variables for testing (optional)
export SLEEPER_LEAGUE_ID="1257057278398300160"
# Run directly
python sleeper_server.py
# Test MCP protocol
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | python sleeper_server.py添加新工具
- 将该功能添加到
sleeper_server.py - 用…装饰
@mcp.tool() - 用新的工具名称更新目录条目
- 重建Docker镜像
API费率限制
睡眠者API的一般费率限制为每分钟1000个API呼叫。此服务器不实施速率限制，因此请注意您的使用情况，以避免被IP阻止。
故障排除
工具未出现
- 验证Docker镜像构建成功：
docker images | grep sleeper - 检查目录和注册表文件的格式是否正确
- 确保Claude Desktop配置包括自定义目录
- 完全重新启动克劳德桌面
API错误
- 验证联盟ID是否正确
- 检查资源是否存在（某些终结点返回空数组表示缺少数据）
- 确保你使用的是有效的周数（常规赛为1-18）
球员数据
- 玩家数据库约为5MB，并定期更新
- 玩家ID在整个API中使用（例如，“4866”、“2391”）
- 使用
search_player_info按ID查找玩家详细信息的工具
安全考虑
- 无需认证（轨枕API为只读）
- 所有数据都是公开的梦幻足球信息
- 在容器中以非root用户身份运行
- 未存储或记录敏感数据
API文档
API全轨枕文件：https://docs.sleeper.com
许可证
MIT许可证