金大哥 - sleeper-scraper-mcp MCP 详情

article

README

🚀 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次以内。

sleeper-scraper-mcp