🚀 Sleeper API MCP
Sleeper API MCP（模型上下文协议）服务器提供了对Sleeper梦幻足球API的访问途径。借助该服务器，使用者可以从Sleeper平台获取用户、联赛、选秀、阵容、对阵以及球员等相关信息。
✨ 主要特性
- 访问用户信息和联赛信息
- 获取联赛详情、阵容和用户信息
- 获取对阵信息和季后赛赛制信息
- 查看交易和选秀权交易情况
- 访问选秀信息和选秀顺位
- 获取球员数据和热门球员信息
- 无需API密钥（Sleeper API为只读模式）
📦 安装指南
依赖安装
pip install requests
使用步骤
- 将此MCP放置在名为
mcp_sleeper的目录中。 - 使用以下
.cursor/mcp.json代码片段配置Cursor：
{
"mcpServers": {
"sleeper": {
"command": "python server.py"
}
}
}
- 启动MCP：
cursor run-mcp sleeper
📚 详细文档
MCP提供了以下工具：
用户数据
getUserInfo：通过用户名或用户ID获取用户信息getUserLeagues：获取指定体育项目和赛季下用户的所有联赛信息getUserDrafts：获取指定体育项目和赛季下用户的所有选秀信息
联赛数据
getLeagueInfo：获取特定联赛的信息getLeagueRosters：获取联赛中的所有阵容信息getLeagueUsers：获取联赛中的所有用户信息getLeagueMatchups：获取联赛中特定周次的对阵信息getLeagueWinnersBracket：获取联赛的季后赛胜者组赛制信息getLeagueLosersBracket：获取联赛的季后赛败者组赛制信息getLeagueTransactions：获取联赛中特定周次的交易信息getLeagueTradedPicks：获取联赛中的所有选秀权交易信息getLeagueDrafts：获取联赛中的所有选秀信息
选秀数据
getDraftInfo：获取特定选秀的信息getDraftPicks：获取选秀中的所有选秀顺位信息getDraftTradedPicks：获取选秀中的所有选秀权交易信息
球员数据
getAllPlayers：获取指定体育项目的所有球员信息getTrendingPlayers：根据球员的添加/移除动态获取热门球员信息
状态数据
getNFLState：获取当前美国职业橄榄球大联盟（NFL）的状态信息
💻 使用示例
基础用法
以下是一个代理如何使用此MCP从Sleeper获取数据的示例：
# 获取用户信息
user_info = getUserInfo({"username_or_user_id": "sleeper_username"})
# 获取用户在2023年NFL赛季的所有联赛信息
leagues = getUserLeagues({"user_id": user_info["user_id"], "sport": "nfl", "season": "2023"})
# 获取特定联赛的信息
league_info = getLeagueInfo({"league_id": leagues[0]["league_id"]})
# 获取联赛的阵容信息
rosters = getLeagueRosters({"league_id": league_info["league_id"]})
# 获取特定周次的对阵信息
matchups = getLeagueMatchups({"league_id": league_info["league_id"], "week": 1})
# 获取热门球员信息
trending_players = getTrendingPlayers({"sport": "nfl", "type": "add", "lookback_hours": 24, "limit": 10})
⚠️ 重要提示
请留意API调用的频率。根据Sleeper的文档说明，为避免IP被封禁，每分钟的API调用次数应控制在1000次以内。