Sleeper Draft Assistant MCP

ピッククロックが動いている間に、ChatGPTに最新のリーグ状況を反映したSleeperドラフトスナップショットを提供する読み取り専用プロトタイプです。

このサーバーは、1つの焦点を絞ったStreamable HTTP MCPツールget_live_draft_contextを公開します。呼び出しのたびに、ドラフト、指名、トレードされた指名権、リーグ、ロースター、リーグユーザーを更新します。返される内容は以下のとおりです。

• マネージャーの指名済み選手、ポジション別人数、埋まっている/空いている先発スロット、ベンチ枠;

• 現在の指名順、指名権を持つマネージャー、ユーザーの次の指名までの指名数;

• リーグのスコアリング、ロースター、ドラフト設定;

• 完全なドラフト履歴と、他のすべてのロースターのポジション別簡潔サマリー;

• 現在未指名の選手をロースターポジション別に一覧表示。

Sleeperの選手メタデータは、/players/nflが大規模で変化の遅いカタログであるため、24時間キャッシュされます。可用性は、呼び出しのたびに新しく取得した指名から計算されます。返されるsleeper_search_rankは発見用メタデータであり、ドラフトアドバイスではありません。別のランキングまたは調査ソースと組み合わせて使用してください。

ローカルでの実行

要件: Node.js 22以降。

npm install
cp .env.example .env
npm run dev

必要に応じてSLEEPER_USER_IDにSleeperのユーザー名またはユーザーIDを設定します。未設定の場合、MCP呼び出しでuserを指定する必要があります。

エンドポイントは以下のとおりです。

• POST /mcp — ステートレスなStreamable HTTP MCP

• GET /health — プロセスのヘルスチェック

• GET / — サービスメタデータ

プロトタイプの検証

npm test
npm run test:integration
npm run typecheck
npm run build
npx @modelcontextprotocol/inspector@latest

MCP Inspectorをhttp://localhost:3000/mcpに向け、ツールを一覧表示し、実際のdraft_idとuserを指定してget_live_draft_contextを呼び出します。

同梱のDockerfileは、HTTPS対応の任意のコンテナホスト向けの本番イメージをビルドします:

docker build -t sleeper-mcp .
docker run --rm -p 3000:3000 -e SLEEPER_USER_ID=your-user sleeper-mcp

ChatGPTで使用するには、エンドポイントをパブリックHTTPSまたはサポートされているセキュアトンネル経由で公開します。次に、Settings → Security and loginでDeveloper modeを有効にし、ChatGPT PluginsからMCPサーバーを追加して、/mcpを含むHTTPS URLを入力します。新しいチャットを開始し、ツールメニューから接続を追加して、モバイルアプリからドラフトに関する質問をします。

セキュアトンネルを使用する場合は、デフォルトのlocalhostバインドを維持してください。サーバーを意図的に公開する場合は、HOST=0.0.0.0を設定し、クライアントがベアラークレデンシャルを送信できる場合はMCP_BEARER_TOKENを構成し、TLSをホスティングエッジに配置します。ブラウザ発信のリクエストは、その正確なオリジンがMCP_ALLOWED_ORIGINSに含まれていない限り拒否されます。サーバー間のMCPリクエストは通常、Originを省略します。

プロトタイプの境界

• 読み取り専用: Sleeperで指名を行ったり、リーグを変更したりするコードパスはありません。

• ランキングエンジンなし: 外部のランキング、プロジェクション、負傷調査、ニュースは別のものとして扱われます。

• スネーク/リニアドラフト: 現在および将来の指名計算は、トレードされた指名権を含め、これらの形式をサポートします。オークションの入札順はサポート対象外として報告されます。

• 公開Sleeperデータ: オプションのベアラートークンはエンドポイントを保護しますが、ユーザーごとの認証ではありません。個人での検証にはセキュアトンネルを使用し、共有サービスとして運用する前にOAuthを追加してください。

• 可用性はSleeperの選手カタログに依存します。有限の正のsearch_rankを持たない選手は、簡潔な候補リストからは除外されますが、指名された場合はドラフト履歴に表示されます。

環境変数

ソース参照

• SleeperのAPIドキュメントは、認証不要の読み取り専用エンドポイントと利用制限について説明しています。

• OpenAIのMCPサーバーガイドは、ツールスキーマ、アノテーション、結果、TypeScript SDKについて説明しています。

• OpenAIの接続ガイドは、パブリックHTTPSまたはセキュアトンネル、MCP Inspector、Developer mode、ChatGPTへの/mcpエンドポイントの追加について説明しています。