Sleeper Scraper MCP

🚀 Sleeper API MCP

このモデルコンテキストプロトコル（MCP）サーバーは、Sleeper Fantasy Football APIへのアクセスを提供します。エージェントは、Sleeperプラットフォームからユーザー、リーグ、ドラフト、ロスター、対戦情報、選手情報に関するデータを取得することができます。

✨ 主な機能

• ユーザー情報とリーグにアクセスする
• リーグの詳細、ロスター、ユーザーを取得する
• 対戦情報とプレーオフのブラケットを取得する
• トランザクションとトレードされたドラフトピックを表示する
• ドラフト情報とドラフトピックにアクセスする
• 選手データと人気の選手情報を取得する
• APIキーは不要（Sleeper APIは読み取り専用）

📦 インストール

必要条件

pip install requests

使用方法

1. このMCPをmcp_sleeperという名前のディレクトリに配置します。
2. 次の.cursor/mcp.jsonのスニペットでCursorを設定します。

{
  "mcpServers": {
    "sleeper": {
      "command": "python server.py"
    }
  }
}

3. 以下のコマンドで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からデータを取得する方法は次のとおりです。

基本的な使用法

# Get user information
user_info = getUserInfo({"username_or_user_id": "sleeper_username"})

# Get user's leagues for the 2023 NFL season
leagues = getUserLeagues({"user_id": user_info["user_id"], "sport": "nfl", "season": "2023"})

# Get information about a specific league
league_info = getLeagueInfo({"league_id": leagues[0]["league_id"]})

# Get rosters for a league
rosters = getLeagueRosters({"league_id": league_info["league_id"]})

# Get matchups for a specific week
matchups = getLeagueMatchups({"league_id": league_info["league_id"], "week": 1})

# Get trending players
trending_players = getTrendingPlayers({"sport": "nfl", "type": "add", "lookback_hours": 24, "limit": 10})

🔧 技術詳細

API呼び出しの頻度に注意してください。Sleeperのドキュメントによると、IPブロックを回避するために、1分あたり1000回以下のAPI呼び出しに抑える必要があります。

📄 ライセンス

参考資料

• Sleeper API Documentation
• Model Context Protocol
• MCP with LLMs