Sleeper 🏈 Model Context Protocol Server

Sleeper 🏈 Model Context Protocol サーバー

Sleeper の各リーグにおける過去の成績にアクセスできる Model Context Protocol（MCP）サーバーです。このサーバーでは、今シーズンの詳細にもアクセスできます。

主要ファイル

index.ts

• 以下の15個の MCP ツールを定義しています。
  • get-current-nfl-week - 現在の NFL 週に関する情報
  • get-trending-players - リーグ全体で追加・削除されたプレイヤーの最多情報
  • get-user-roster-trending-players - ユーザーのロスターでトレンドになっているプレイヤー
  • get-league-names-for-user - ユーザー名に紐づくすべてのリーグ
  • get-league-settings - リーグの一般設定
  • get-league-playoff-schedule - プレーオフの構成と日程
  • get-league-scoring-settings - 詳細なスコアリングルール
  • get-league-roster-settings - スターティングラインナップの要件
  • get-matchup-details - 指定した週の直接対決の概要
  • get-matchup-starters - 指定した対戦の両チームのスターターを取得します
  • get-league-playoff-history - 過去のプレーオフ結果
  • get-matchup-bench - 指定した対戦の両チームのベンチ入りプレイヤーを取得します
  • get-bench-starter-analysis - 指定した対戦のラインナップ最適化分析
  • get-season-head-to-head - シーズンをまたいだライバル関係の完全な対戦記録
  • get-league-playoff-bracket - リーグのプレーオフのトーナメント表を取得します

utils/processors.ts

• このファイルでは、過去のデータ検索を必要とするツールの実装の詳細を扱います。
• 過去のリーグ情報へのアクセスを可能にする processLeagueDataByYear という関数を定義しています。
  • Sleeper API は過去のリーグデータに直接アクセスできないため、previous_league_id の参照をたどってリーグチェーンを手動で構築する必要があります。この関数はそのために不可欠です。
  • この関数を使用すると、クライアントは "2022"、"2022-2024"、"2020, 2022, 2024" などの年の範囲を指定できます。
  • この関数を使用する各ツールでは、アクセスするエンドポイントの種類に応じて、指定した年の出力を整形するプロセッサー関数を用意する必要があります。

utils/api.ts

• Sleeper API と通信するための API 呼び出しを格納しています。

はじめに

前提条件：

• Node.js
• npm
• Claude Desktop App

インストール：

1. リポジトリをクローンします

   git clone https://github.com/asotiropusc/sleeper-mcp-server.git
   cd sleeper-mcp-server
   

2. 依存関係をインストールします

   npm install
   

設定：

この MCP サーバーを使用するには、Claude Config を使って Claude Desktop に登録する必要があります。設定ファイルを開くには：

Mac の場合：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows の場合：

code $env:AppData\Claude\claude_desktop_config.json

claude_desktop_config.json に以下を追加します：

{
  "mcpServers": {
    "sleeper-fantasy-football": {
      "command": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/sleeper-mcp-server/node_modules/.bin/tsx",
      "args": [
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/sleeper-mcp-server/src/index.ts"
      ]
    }
  }
}