Fantasy Football MCP Public

🚀 ファンタジーフットボールMCPサーバー

Yahooファンタジーフットボール用の包括的なモデルコンテキストプロトコル（MCP）サーバーです。AIベースのツールを通じて、スマートなラインナップ最適化、ドラフト支援、リーグ管理を提供します。

🚀 クイックスタート

このサーバーは、Yahooファンタジーフットボールのリーグ管理やラインナップ最適化などの機能を提供します。以下のセクションでは、その機能や使い方、設定方法などを詳しく説明します。

✨ 主な機能

コア機能

• 複数リーグ対応 – アカウントに関連付けられたすべてのYahooファンタジーフットボールリーグを自動的に検出し、管理します。
• 🆕 選手強化レイヤー – バイ週検出、最近の成績統計、急上昇/衰退選手フラグを用いたスマートな予測調整機能。
• スマートなラインナップ最適化 – 対戦相手、専門家の予測、ポジション正規化された価値を考慮した高度なアルゴリズム。
• ドラフトアシスタント – 戦略ベースの分析とVORP計算に基づくリアルタイムのドラフト推薦。
• 包括的な分析 – Redditのセンチメント分析、チーム比較、パフォーマンス指標。
• 複数のデプロイメントオプション – FastMCP、従来のMCP、Docker、クラウドデプロイメントをサポート。

高度な分析

• ポジション正規化 – 異なるポジションのベースラインを考慮したスマートなFLEX選択。
• 複数ソースの予測 – YahooとSleeperの専門家ランキングを対戦分析と組み合わせます。
• 戦略ベースの最適化 – 保守的、攻撃的、バランスの取れたアプローチ。
• ボラティリティスコアリング – 安定したプレイか大きな成功/失敗の可能性を分析。
• ライブドラフトサポート – アクティブなドラフト中のリアルタイムの推薦。

🆕 選手強化レイヤー

強化レイヤーは、現実世界のコンテキストを選手データに追加し、古い予測を修正し、一般的なミスを防ぎます。

主要機能

✅ バイ週検出 – バイ週の選手の予測を自動的にゼロにし、「BYE WEEK - DO NOT START」を表示し、誤ったスタートを防ぎます。

✅ 最近の成績統計 – Sleeper APIから過去1 - 3週間の実際の成績を取得し、トレンドを表示します（L3W平均：X.Xポイント/試合）。

✅ 成績フラグ – 以下を含むスマートなアラート：

• BREAKOUT_CANDIDATE – 最近の成績が予測の150%を超える。
• TRENDING_UP – 最近の成績が予測を上回る。
• DECLINING_ROLE – 最近の成績が予測の70%未満。
• HIGH_CEILING – 爆発的な上昇可能性。
• CONSISTENT – 信頼できる、安定したパフォーマンス。

✅ 調整済み予測 – 最近の実績と古い予測をブレンドし、より正確なスタート/ベンチ決定を行います（信頼度に基づいて60/40または70/30の重み付け）。

例

強化前:

{
  "name": "Rico Dowdle",
  "sleeper_projection": 4.0,
  "recommendation": "Bench"
}

強化後:

{
  "name": "Rico Dowdle",
  "sleeper_projection": 4.0,
  "adjusted_projection": 14.8,
  "performance_flags": ["BREAKOUT_CANDIDATE", "TRENDING_UP"],
  "enhancement_context": "Recent breakout: averaging 18.5 pts over last 3 weeks",
  "recommendation": "Strong Start"
}

強化レイヤーは非破壊的で、以下に自動的に適用されます。

• ff_get_roster (include_external_data=Trueの場合)
• ff_get_waiver_wire (include_external_data=Trueの場合)
• ff_get_players (include_external_data=Trueの場合)
• ff_build_lineup (自動的に)

🛠️ 利用可能なMCPツール

リーグとチーム管理

• ff_get_leagues – 認証されたYahooアカウントのすべてのリーグをリスト表示します。
• ff_get_league_info – 詳細なリーグメタデータとチーム情報を取得します。
• ff_get_standings – 勝敗とポイントを含む現在のリーグ順位を表示します。
• ff_get_roster – 任意のチームの詳細なロスター情報を調べます。
• ff_get_matchup – 週間の対戦詳細と予測を分析します。
• ff_compare_teams – トレード/分析のためのチームロスターの並列比較。
• ff_build_lineup – 高度な最適化アルゴリズムを使用して最適なラインナップを生成します。

選手発見とウェイバーワイヤー

• ff_get_players – 所有率を含む利用可能なフリーエージェントを閲覧します。
• ff_get_waiver_wire – 専門家の分析を含むスマートなウェイバーワイヤーターゲット（カウントを設定可能）。
• ff_get_draft_rankings – Yahooのドラフト前ランキングとADPデータにアクセスします。

ドラフトアシスタントツール

• ff_get_draft_recommendation – 戦略分析を伴うAIベースのドラフト選択提案。
• ff_analyze_draft_state – ドラフト中のリアルタイムのロスターニーズとポジション分析。
• ff_get_draft_results – グレードとチーム概要を含むドラフト後の分析。

高度な分析

• ff_analyze_reddit_sentiment – 選手の評判や怪我の更新に関するソーシャルメディアのセンチメント分析。
• ff_get_api_status – キャッシュパフォーマンスとYahoo APIのレート制限を監視します。
• ff_clear_cache – 新しいデータを取得するためにキャッシュされたレスポンスをクリアします（パターンサポート付き）。
• ff_refresh_token – Yahoo OAuthトークンを自動的に更新します。

📦 インストール

クイックスタート

git clone https://github.com/derekrbreese/fantasy-football-mcp-public.git
cd fantasy-football-mcp-public
pip install -r requirements.txt

Yahoo APIの設定

1. developer.yahoo.comでYahoo Developerアプリを作成します。
2. コンシューマキー（クライアントID）とコンシューマシークレット（クライアントシークレット）をメモします。
3. これらの資格情報を使用して.envファイルを設定します。
4. 含まれている認証スクリプトを使用してOAuthフローを完了します。

⚙️ 設定

API資格情報を含む.envファイルを作成します。

# Yahoo API Credentials (Required)
YAHOO_CLIENT_ID=your_consumer_key_here
YAHOO_CLIENT_SECRET=your_consumer_secret_here
YAHOO_ACCESS_TOKEN=your_access_token
YAHOO_REFRESH_TOKEN=your_refresh_token
YAHOO_GUID=your_yahoo_guid

# Reddit API Credentials (Optional - for sentiment analysis)
REDDIT_CLIENT_ID=your_reddit_client_id
REDDIT_CLIENT_SECRET=your_reddit_client_secret
REDDIT_USERNAME=your_reddit_username

注意: Redditの資格情報はオプションです。これらがなくてもアプリは動作しますが、Redditのセンチメント分析機能は利用できません。詳細な手順については、Reddit API Setup Guideを参照してください。

初期認証

初回設定:

cd utils
python setup_yahoo_auth.py

再認証（トークンが期限切れの場合）:

cd utils
python reauth_yahoo.py

トークン更新（アクセストークンが期限切れの場合）:

cd utils
python refresh_yahoo_token.py

認証スクリプトは以下を行います。

• Yahoo OAuth承認のためにブラウザを開きます。
• .envファイルを自動的に更新します（既存の変数の行位置を保持）。
• MCP設定ファイル（Claude Desktop、Cursor、Antigravity）が存在する場合は自動的に更新します。
• 確認メッセージを表示します。

重要: 認証またはトークン更新後、新しいトークンを使用するためにMCPクライアントを再起動してください。

🚀 デプロイメントオプション

ローカル開発（FastMCP）

python fastmcp_server.py

http://localhost:8000でHTTPトランスポートを介して接続します。

Claude Code統合（Stdio）

python fantasy_football_multi_league.py

Dockerデプロイメント

docker build -t fantasy-football-mcp .
docker run -p 8080:8080 --env-file .env fantasy-football-mcp

クラウドデプロイメント（Render/Railwayなど）

サーバーは、さまざまなクラウドプラットフォーム用の複数の互換性レイヤーを含んでいます。

• render_server.py - Render.comデプロイメント
• simple_mcp_server.py - 汎用HTTP/WebSocketサーバー
• fastmcp_server.py - FastMCPクラウドデプロイメント

🧪 テスト

# 完全なテストスイートを実行
pytest

# OAuth認証をテスト
python tests/test_oauth.py

# MCP接続をテスト
python tests/test_mcp_client.py

📁 プロジェクト構造

fantasy-football-mcp-public/
├── fastmcp_server.py              # FastMCP HTTPサーバーの実装
├── fantasy_football_multi_league.py  # メインのMCP stdioサーバー
├── lineup_optimizer.py            # 高度なラインナップ最適化エンジン
├── matchup_analyzer.py           # 防御的な対戦分析
├── position_normalizer.py        # FLEXポジションの価値計算
├── src/
│   ├── agents/                   # 特殊な分析エージェント
│   ├── models/                   # 選手、ラインナップ、ドラフトのデータモデル
│   ├── strategies/              # ドラフトとラインナップの戦略
│   ├── services/                # 選手強化と外部統合
│   └── utils/                   # ユーティリティ関数と設定
├── tests/                       # 包括的なテストスイート
├── utils/                       # 認証とトークン管理
└── requirements.txt             # Pythonの依存関係

🔧 高度な設定

戦略重み（バランスの取れたデフォルト）

{
    "yahoo": 0.40,     # Yahooの専門家予測
    "sleeper": 0.40,   # Sleeperの専門家ランキング
    "matchup": 0.10,   # 防御的な対戦分析
    "trending": 0.05,  # 選手のトレンドデータ
    "momentum": 0.05   # 最近の成績
}

ドラフト戦略

• 保守的：実績のある選手を優先し、リスクを最小限に抑えます。
• 攻撃的：高い上昇可能性のある急上昇候補を狙います。
• バランスの取れた：安全性と上昇可能性の最適なミックス。

ポジションスコアリングベースライン

• RB: ~11ポイント（標準スコアリング）
• WR: ~10ポイント（標準スコアリング）
• TE: ~7ポイント（標準スコアリング）
• FLEX計算にはポジションの希少性調整が含まれます。

📊 パフォーマンス指標

最適化エンジンは以下を目標としています。

• 85%以上のスタート/ベンチ決定の精度
• 最適な決定ごとに平均**+2.0ポイント**
• 手動選択に対して90%以上のラインナップ効率
• ポジション正規化されたFLEX決定で、TEトラップを回避

🔍 トラブルシューティング

一般的な問題

認証エラー

# 期限切れのトークンを更新する（1時間で期限切れ）
cd utils
python refresh_yahoo_token.py

# 更新が失敗した場合は完全な再認証
cd utils
python reauth_yahoo.py

# または初回設定
cd utils
python setup_yahoo_auth.py

注意: すべての認証スクリプトは、.envファイルとMCP設定ファイルを自動的に更新します。いずれかの認証スクリプトを実行した後、新しいトークンを使用するためにMCPクライアントを再起動してください。

1つのリーグのみが表示される

• YAHOO_GUIDがYahooアカウントと一致することを確認します。
• リーグが現在のシーズンにアクティブであることを確認します。
• ログでチーム所有権の検出を確認します。

レート制限

• Yahooは1時間あたり1000リクエストを許可します。
• サーバーは1時間あたり900リクエストの安全な制限を実装しています。
• ff_get_api_statusを使用して使用状況を監視します。
• 必要に応じてff_clear_cacheでキャッシュをクリアします。

古いデータ

• キャッシュのTTL：リーグ（1時間）、順位（5分）、選手（15分）
• ff_clear_cacheツールで強制的に更新します。
• ff_get_api_statusで最後の更新時間を確認します。

🤝 コントリビューション

これはファンタジーフットボールMCPサーバーの公開バージョンです。コントリビュートするには以下の手順を実行してください。

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 新しい機能に対するテストを追加します。
4. すべてのテストが通過することを確認します。
5. プルリクエストを送信します。

📄 ライセンス

MITライセンス - 詳細についてはLICENSEファイルを参照してください。

🙏 謝辞

• 包括的なリーグデータのためのYahooファンタジースポーツAPI
• 専門家のランキングと防御分析のためのSleeper API
• 選手のセンチメント分析のためのReddit API
• モデルコンテキストプロトコル（MCP）フレームワーク

注意: このサーバーは、アクティブなYahooファンタジーフットボールリーグと有効なAPI資格情報を必要とします。リーグデータにアクセスする前に、適切な承認を取得してください。